Nestor Documentation
Everything you need to build, deploy, and manage AI agents with trust and accountability.
Quickstart
Get your first agent running in under 5 minutes.
Agents
Create, configure, and manage AI agents.
Workflows
Orchestrate multi-agent teams with DAG workflows.
Security
Sandbox, guardrails, trust scores, and the Rust security core.
What is Nestor?
Nestor is an open-source AI agent platform designed for developers who need autonomous agents they can actually trust. It provides a complete stack from CLI to web dashboard, with security built into every layer.
Key Capabilities
- 6 LLM Providers — Claude, OpenAI, Gemini, Grok, Mistral, and Ollama with unified API
- Rust Security Core — SSRF protection, path traversal prevention, secret redaction via N-API
- Docker Sandbox — Isolated execution with cap-drop ALL and read-only filesystem
- DAG Workflows — Multi-agent orchestration with parallel execution and governance gates
- Trust Scores — A-F grading based on real execution history
- Dry-Run Mode — Preview actions before execution
- RAG Codebase Understanding — Semantic search across your entire project
- Studio Dashboard — Web UI for monitoring, editing workflows, and tracking costs
Architecture
Nestor is built as a monorepo with distinct packages, each with a clear responsibility:
| Package | Role |
|---|---|
@nestor/cli | Command-line interface with 12+ commands |
@nestor/agent | Agent runtime, LLM adapters, tool execution |
@nestor/server | Express + WebSocket server for Studio |
@nestor/orchestrator | DAG workflow engine with cron scheduling |
@nestor/mcp | Model Context Protocol tools and resources |
@nestor/db | SQLite database with 14 tables |
@nestor/skill-tester | Skill testing framework with mock LLM |
nestor-core | Rust security module compiled to N-API |
CLI Quick Reference
# Installation
npx nestor-sh install
# Agent management
nestor agent create --name coder --adapter claude
nestor agent list
nestor agent config coder
# Interactive shell
nestor shell
nestor shell --agent coder --model claude-sonnet-4-6
# Web Studio
nestor start
# Workflows
nestor workflow run code-review.yaml
nestor workflow list
# Testing
nestor test
nestor test --file tests/my-skill.test.yaml
nestor test --verbose
Next Steps
- Follow the Quickstart Guide to set up your first agent
- Learn about agent configuration and customization
- Explore DAG workflows for multi-agent orchestration
- Understand the security model and trust scoring