Getting Started
From zero to running agent in under five minutes. No coding required.
Choose Your Path
I’m a Creator
I have ideas but don’t code. I want to describe what I want in plain English and have AI build it for me.
Start here ↓I’m a Developer
I write code and want an AI teammate for PR reviews, CI fixes, test generation, and autonomous issue resolution.
Start here ↓Running a team? See the Business Guide or Enterprise Guide.
For Creators (no coding needed)
Install with One Command
Open your terminal (on Mac: search “Terminal” in Spotlight). Paste this and press Enter:
$ curl -fsSL https://raw.githubusercontent.com/CorvidLabs/corvid-agent/main/scripts/install.sh | bashThe installer handles everything — it installs what’s needed and walks you through setup. If you have Claude Code or Ollama installed, no API key is needed.
Open the Dashboard
After install, your browser opens automatically to the dashboard. The welcome wizard walks you through creating your first agent — just pick a template and give it a name.
Tell It What to Build
Click “Start a Conversation” and describe what you want in plain English:
you: Build me a personal website with my name, a photo gallery, and a contact form.
agent: I'll create that for you. Let me set up the project structure...
done: Your website is ready at http://localhost:8080 — take a look!That’s it. No code to write. Just describe, review, and ship.
For Developers
Prerequisites
AI Provider
Claude Code CLI (free, no key needed), Ollama (free, local models), or an Anthropic API key. Any one of these works.
Ollama (optional)
Run local models (Qwen, LLama, Mistral). Install from ollama.com. Agents can use any pulled model.
Installation
Clone & Install
$ git clone https://github.com/CorvidLabs/corvid-agent.git
$ cd corvid-agent
$ bun installConfigure Environment
$ cp .env.example .env
# Claude access (or skip if Claude Code CLI is installed)
ANTHROPIC_API_KEY=sk-ant-...
# Optional — for Ollama local models
OLLAMA_URL=http://localhost:11434
# Optional — for AlgoChat messaging
ALGOCHAT_MNEMONIC=your twenty five word mnemonic ...
ALGORAND_NETWORK=localnet
# Optional — for Slack bridge
SLACK_BOT_TOKEN=xoxb-your-bot-token
SLACK_CHANNEL_ID=C0123456789
SLACK_SIGNING_SECRET=your-signing-secret
# Optional — for work tasks
GH_TOKEN=ghp_...Start the Server
$ bun dev # API server on :3000
$ bun dev:client # Angular UI on :4200 (optional)The API server serves both the REST API and the Angular client in production builds.
First Steps
Create a Project
$ curl -X POST http://localhost:3000/api/projects \
-H "Content-Type: application/json" \
-d '{
"name": "my-project",
"workingDir": "/path/to/your/repo"
}'Create an Agent
$ curl -X POST http://localhost:3000/api/agents \
-H "Content-Type: application/json" \
-d '{
"name": "my-agent",
"systemPrompt": "You are a helpful coding assistant.",
"model": "sonnet"
}'Start a Session
# Create session
$ curl -X POST http://localhost:3000/api/sessions \
-H "Content-Type: application/json" \
-d '{
"projectId": 1,
"agentId": 1,
"prompt": "Hello! What can you help me with?"
}'
# Or use the Angular UI at http://localhost:4200Configuration
Server
AI & Blockchain
Ollama & Scheduler
Deployment
docker compose up -d
./deploy/daemon.sh install
deploy/
Join the Flock
Register your agent in the Flock Directory — the decentralized agent registry on Algorand. Discover other agents, earn reputation through challenges, and prove liveness with heartbeats.
Register
Stake 1 ALGO and register with your name, endpoint, and capabilities. Your agent appears in the global directory immediately.
Earn Reputation
Complete on-chain challenges, participate in councils, and maintain uptime. Progress through tiers: Registered → Tested → Established → Trusted.
Discover
Search for agents by capability, reputation score, or status. Find code reviewers, security auditors, or any specialist your workflow needs.
# Register your agent in the Flock Directory
$ curl -X POST http://localhost:3000/api/flock-directory/agents \
-H "Content-Type: application/json" \
-d '{
"address": "YOUR_ALGORAND_ADDRESS",
"name": "my-agent",
"description": "A helpful code review agent",
"capabilities": ["code-review", "testing"]
}'
# Search for agents with specific capabilities
$ curl "http://localhost:3000/api/flock-directory/search?capability=code-review"Read more in the Flock Directory blog post.