Authentication
Requests carry a JWT bearer token. Where it comes from depends on where your code runs. Many local endpoints also answer unauthenticated on localhost.
| Your code runs in | The token comes from |
|---|---|
| A widget | The agnt SDK handles it |
| The frontend | The signed-in session |
| An orchestrator tool | process.env.AGNT_AUTH_TOKEN, injected for you |
Authorization: Bearer <your-jwt-token>First calls
The base URL is http://localhost:3333/api/. Your code talks to your own runtime; there is no cloud API to learn.
curl http://localhost:3333/api/agents/healthconst res = await fetch('http://localhost:3333/api/agents/', {
headers: { Authorization: 'Bearer ' + token },
});
const agents = await res.json();Connect a model
Settings → Providers. Mix freely: a local model for routine volume, a frontier model for the hard steps, and change any agent's provider later without rebuilding it.
| Route | How | Trade-off |
|---|---|---|
| Cloud API key | One key from OpenAI, Anthropic, Google Gemini, Grok, DeepSeek, Mistral and others | Strongest models; per-token cost; data leaves for the model call |
| Fully local | Point AGNT at Ollama (port 11434) or LM Studio (port 1234) | No per-token cost and complete privacy; needs capable hardware |
{
"provider": "ollama",
"baseUrl": "http://localhost:11434",
"defaultModel": "llama3.3:70b"
}Run with Docker
One image with the full feature set, including browser automation. Needs Docker 20.10+ or Docker Desktop, 2 GB of free RAM and 2 GB of free disk. Pin a version tag so an update is a decision, not a surprise.
docker run -d \
--name agnt-full \
-p 3333:3333 \
-v agnt-data:/app/data \
-e NODE_ENV=production \
-e BASE_URL=http://localhost:3333 \
--restart unless-stopped \
ghcr.io/agnt-gg/agnt:0.6.6All documentation
Generated from the docs pipeline, so it is always current with what is published.
Frequently asked questions
Is my data sent to AGNT servers when using Community Core?
No. Community Core runs 100% locally. Your prompts, code files, credentials, and receipts stay on your machine unless you explicitly connect a remote cloud provider.
Can I use AGNT without an internet connection?
Yes. When connected to local models via Ollama or LM Studio, AGNT functions completely offline for all filesystem, local shell, and code editing operations.
How do approval gates work for dangerous operations?
Any action that modifies system settings, executes arbitrary shell scripts, or sends external emails triggers a visual approval modal in AGNT before execution.