Skip to content

fix: broken link in readme #221

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jun 26, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 9 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Magentic-UI is a **research prototype** of a human-centered interface powered by

Here's how you can get started with Magentic-UI:

> **Note**: Before installing, please read the [pre-requisites](#pre-requisites) carefully. Magentic-UI requires Docker to run, and if you are on Windows, you will need WSL2. We recommend using [uv](https://docs.astral.sh/uv/getting-started/installation/) for a quicker installation. If you are using Mac or Linux, you can skip the WSL2 step.
> **Note**: Before installing, please read the [pre-requisites](#-pre-requisites) carefully. Magentic-UI requires Docker to run, and if you are on Windows, you will need WSL2. We recommend using [uv](https://docs.astral.sh/uv/getting-started/installation/) for a quicker installation. If you are using Mac or Linux, you can skip the WSL2 step.

```bash
python3 -m venv .venv
Expand Down Expand Up @@ -51,16 +51,16 @@ pip install magentic-ui[azure]
pip install magentic-ui[ollama]
```

For further details on installation please read the <a href="#installation">🛠️ Installation</a> section. For common installation issues and their solutions, please refer to the [troubleshooting document](TROUBLESHOOTING.md).
For further details on installation please read the <a href="#%EF%B8%8F-installation">🛠️ Installation</a> section. For common installation issues and their solutions, please refer to the [troubleshooting document](TROUBLESHOOTING.md).


## Quick Navigation:
<p align="center">
<a href="#how-it-works">🟪 How it Works</a> &nbsp;|&nbsp;
<a href="#installation">🛠️ Installation</a> &nbsp;|&nbsp;
<a href="#troubleshooting">⚠️ Troubleshooting</a> &nbsp;|&nbsp;
<a href="#contributing">🤝 Contributing</a> &nbsp;|&nbsp;
<a href="#license">📄 License</a>
<a href="#-how-it-works">🟪 How it Works</a> &nbsp;|&nbsp;
<a href="#%EF%B8%8F-installation">🛠️ Installation</a> &nbsp;|&nbsp;
<a href="#%EF%B8%8F-troubleshooting">⚠️ Troubleshooting</a> &nbsp;|&nbsp;
<a href="#-contributing">🤝 Contributing</a> &nbsp;|&nbsp;
<a href="#-license">📄 License</a>
</p>

---
Expand Down Expand Up @@ -154,7 +154,7 @@ If using Docker Desktop, make sure it is set up to use WSL2:



2. During the Installation step, you will need to set up your `OPENAI_API_KEY`. To use other models, review the [Custom Client Configuration](#custom-client-configuration) section below.
2. During the Installation step, you will need to set up your `OPENAI_API_KEY`. To use other models, review the [Custom Client Configuration](#Configuration) section below.

3. You need at least [Python 3.10](https://www.python.org/downloads/) installed.

Expand Down Expand Up @@ -397,7 +397,7 @@ The frontend from source will be available at <http://localhost:8000>, and the c

## ⚠️ Troubleshooting

If you were unable to get Magentic-UI running, do not worry! The first step is to make sure you have followed the steps outlined above, particularly with the [pre-requisites](#pre-requisites).
If you were unable to get Magentic-UI running, do not worry! The first step is to make sure you have followed the steps outlined above, particularly with the [pre-requisites](#-pre-requisites).

For common issues and their solutions, please refer to the [TROUBLESHOOTING.md](TROUBLESHOOTING.md) file in this repository. If you do not see your problem there, please open a `GitHub Issue`.

Expand Down