MiniAgentHarness

⚡️ 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.

Features

• 🧪 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

Quickstart

# 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

CLI

| 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) |

Contributing

PRs welcome! Check TASKS.md for the active roadmap. For local development:

poetry install --with dev
pre-commit install

License

MIT © Haluk Sonmezler