⚡️ Small, test-first AI-agent starter kit with one-click deploy.
MiniAgentHarness gives you a production-ready scaffold for building ReAct-style language-model agents with a built-in Pytest harness so you catch prompt regressions before they reach prod. Spin it up locally, run pytest, and deploy to Vercel in minutes.
- 🧪 Testing harness — Pytest plugin, DeepEval metrics, LangSmith replays (coming soon)
- 🚀 Zero-config deploy — FastAPI backend + React chat, ready for Vercel Edge / CF Workers
- 🧩 Tool registry — YAML → auto-imported Python stubs (generate via CLI)
- 📦 Batteries included — CLI, CI workflow, linting hooks, example agents & tests
# 1. Install (Poetry recommended)
pipx install poetry # if you don't already have it
git clone https://github.com/HalukProductions/MiniAgentHarness.git && cd MiniAgentHarness
poetry install
# 2. Run unit tests (stub passes green)
poetry run pytest -q
# 3. Generate an example agent
poetry run mini-agent init # creates agents/quickstart.yaml
# 4. (Soon) Serve with your favourite model
poetry run mini-agent serve --model ollama/llama3| Command | Description |
|---|---|
mini-agent init |
Generate a stub agent YAML & tool skeleton |
mini-agent test |
Run Pytest suite (wrapper) |
mini-agent serve |
Start FastAPI + React UI (TBA) |
PRs welcome! Check TASKS.md for the active roadmap. For local development:
poetry install --with dev
pre-commit installMIT © Haluk Sonmezler