Document and preflight all dependencies

- README: explicit install commands for Ollama (macOS/Linux/Windows) and Python
  3.12 per OS; note curl as a run.sh dependency
- setup.sh / setup.ps1: preflight checks that Ollama is installed and reachable
  (with install hints if missing); setup.sh also warns if curl is absent

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Joseph Costa
2026-07-05 02:15:22 -05:00
co-authored by Claude Opus 4.8
parent 95da8fb38d
commit 5bd8142d30
3 changed files with 40 additions and 4 deletions
+11 -4
View File
@@ -41,10 +41,17 @@ Python 3.9+. LiteLLM (the backend proxy) needs a small venv.
## Requirements
- [Ollama](https://ollama.com) running locally with some models pulled
- **Python 3.12** (for the LiteLLM venv). macOS: `brew install python@3.12`.
Linux: your distro's `python3.12`.
- The pre-router itself only needs any Python 3.9+.
- **[Ollama](https://ollama.com)** — the model backend. Install:
- macOS: `brew install ollama` (or the app from [ollama.com/download](https://ollama.com/download))
- Linux: `curl -fsSL https://ollama.com/install.sh | sh`
- Windows: `winget install Ollama.Ollama`
- **Python 3.12** — for the LiteLLM venv:
- macOS: `brew install python@3.12` · Linux: distro `python3.12` · Windows: `winget install Python.Python.3.12`
- The pre-router itself needs only any Python 3.9+.
- **curl** — used by `run.sh` for health checks (standard on macOS/Linux).
`./scripts/setup.*` checks Python **and** Ollama for you and installs the Python
deps; `./scripts/pull-models.*` fetches the model fleet.
## Quickstart