AGNT is a local-first runtime for AI agents: it installs on your machine, runs agents and workflows there, and produces a receipt for every job. Community Core is free forever and needs no account to run locally.
Ten minutes, four steps.
1. Install
Grab the installer for your platform from the downloads page:
| Platform | What you get |
|---|---|
| Windows | Signed .exe installer |
| macOS | Signed and notarized .dmg — Apple Silicon and Intel builds |
| Linux | .deb, .AppImage or .rpm |
Installers are signed for Windows and signed + notarized for macOS, so they open like any other app — no security workarounds needed.
Headless / server? AGNT runs the same runtime in Docker:
docker run -d -p 3333:3333 --name agnt agnt/agnt:latestThe full container guide — full vs lite images, volumes, updating — is at Run AGNT with Docker.
2. Connect a model
Agents need a model to think with. Open Settings → Providers and pick one of two routes:
| Route | How | Trade-off |
|---|---|---|
| Cloud API key | Paste one key from OpenAI, Anthropic, Gemini, Grok, Groq, OpenRouter or a dozen others | Strongest models; per-token cost; data leaves your machine for the model call |
| Fully local | Point AGNT at Ollama or LM Studio running on your machine | Zero per-token cost, complete privacy; needs decent hardware for good models |
You can mix freely — a local model for high-volume routine work, a frontier model for the hard steps — and change any agent's provider later without rebuilding anything.
3. Give an agent a job
Three ways in, easiest first:
- Chat. Open the chat and ask for something real: "Watch this folder and summarize any PDF that lands in it." Annie can build the agent and workflow for you.
- Fork something working. The marketplace has ready-made agents, workflows and skills — install one and make it yours.
- Build on the canvas. Open Workflows, drag a trigger (schedule, webhook, email), wire it to agent and tool nodes, press run.
Whichever route you take, every run writes a receipt: what was requested, which tools ran with what inputs and outputs, what it cost, what came out. Trust the work because you can check the work.
4. Put it on your phone (optional)
In Settings → Configuration → Phone Access, toggle access on and scan the QR code — your phone joins the session without typing a token. The QR carries a single-use, two-minute code, never your credentials. The full protocol and its security model: Phone Access & Pairing.
Where next
- API Quickstart — drive everything programmatically from
http://localhost:3333/api/ - Use cases — twelve real jobs teams hand to agents, with the workflows that run them
- Integrations — connect Slack, Gmail, Notion, GitHub, Stripe and 30+ more
- Run AGNT with Docker — self-host on a server or VPS
Stuck? The FAQ on the docs index covers the common first-run questions.