> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marcodewey.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Run the four demo APIs locally and try them from this site's API playground.

You can read this whole site without running anything. To use the **Try it** playground, run an API on your laptop.

change

marco making changes

new line. test.

**1. Check what you need**

You need Python 3.10 or newer and `git`.

> [tab] macOS
>
> ```bash theme={null}
> brew install python git
> ```

> [tab] Linux
>
> ```bash theme={null}
> sudo apt install python3 python3-venv git
> ```

> [tab] Windows
>
> ```powershell theme={null}
> winget install Python.Python.3.12 Git.Git
> ```

**2. Pick an API and start it**

```bash Merge Sort API theme={null}
git clone https://github.com/mintlify-demo/merge-sort-api.git
cd merge-sort-api
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload
```

```bash Calculator API theme={null}
git clone https://github.com/mintlify-demo/calculator-api.git
cd calculator-api
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload
```

```bash Todo API theme={null}
git clone https://github.com/mintlify-demo/todo-api.git
cd todo-api
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload
```

```bash Text Utils API theme={null}
git clone https://github.com/mintlify-demo/text-utils-api.git
cd text-utils-api
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload
```

> [!WARNING]
>
> Every API uses port `8000`. Run one at a time, or start others with `--port 8001`.

**3. Open its API reference**

Choose the matching tab at the top of this site, pick an endpoint, and click **Try it**. The playground sends the request from your browser straight to `http://localhost:8000`.

**4. Send a request**

For the Todo API, enter `demo-key` as the API key. Every other API needs no key.

> [!TIP]
>
> You're running a real API and calling it from generated docs.

> [!TIP]
>
> Showing this live? Start the API before the call, and keep your browser on the endpoint page. The playground, the code samples and the response viewer all update as you type.

## Troubleshooting

> [accordion] The playground says it can't reach the server
>
> Make sure the API is running and shows `Uvicorn running on http://127.0.0.1:8000`. The APIs allow cross-origin requests, so no extra setup is needed.

> [accordion] `pip install` fails
>
> Check that you activated the virtual environment: your prompt should start with `(.venv)`.

> [accordion] Port 8000 is already in use
>
> Stop the other API, or run `uvicorn main:app --port 8001`.

## How this site is built

Each API's code and tests live in that API's repository. All of the docs, including each API's guides and OpenAPI spec, live in the [docs repository](https://github.com/mintlify-demo/docs). When an API's code changes, Mintlify's agent opens a pull request in the docs repository with the matching docs update.

```mermaid theme={null}
flowchart LR
    A[merge-sort-api] -- code change --> M{{Mintlify agent}}
    B[calculator-api] -- code change --> M
    C[todo-api] -- code change --> M
    D[text-utils-api] -- code change --> M
    M -- docs PR --> E[docs]
    E --> S[One docs site]
```

> [card] [Components](https://docs.marcodewey.com/showcase/components.md)
>
> Every building block used on this site.

> [card] [AI features](https://docs.marcodewey.com/showcase/ai.md)
>
> The assistant, llms.txt, the MCP server and more.
