This path sets up AgentFlow, starts the local API, and proves that it can answer a health request. The recommended first run needs No Docker services or provider API keys after package installation.
Stop here once the API answers. Use the deployment walkthrough for other runtime profiles, the API walkthrough for useful reads, the full API reference for exact request and response contracts, and the contributor guide for repository and documentation work.
- Python
3.11+ - Git
=== "PowerShell"
```powershell
git clone https://github.com/brownjuly2003-code/agentflow.git
cd agentflow
. .\scripts\setup.ps1
```
=== "macOS / Linux"
```bash
git clone https://github.com/brownjuly2003-code/agentflow.git
cd agentflow
source ./scripts/setup.sh
```
The cross-platform runner prepares demo data and starts the API on
http://localhost:8000:
python scripts/demo_local.pyThe command runs in the foreground. Leave it open while checking the service from another terminal.
curl http://localhost:8000/v1/healthExpect HTTP 200 with an overall healthy status. The exact payload and error
contract belong to the
health reference.
| Next task | Detailed owner |
|---|---|
| Prepare data without a server or choose a container-backed profile | Deployment walkthrough |
| Discover data, read an entity, or run a query | API walkthrough |
| Check authentication, parameters, response fields, or errors | Full API reference |
| Preview this site or verify a repository change | Contributor guide |