From zero to running agent in under five minutes.
Only needed for on-chain AlgoChat messaging. Without it, everything still works — chat via the web UI, agents run sessions, councils deliberate. Install via pipx install algokit if you want Localnet or Testnet messaging.
$ git clone https://github.com/CorvidLabs/corvid-agent.git
$ cd corvid-agent
$ bun install
$ cp .env.example .env
# Required
ANTHROPIC_API_KEY=sk-ant-...
# Optional — for AlgoChat messaging
ALGOCHAT_MNEMONIC=your twenty five word mnemonic ...
ALGORAND_NETWORK=testnet
# Optional — for work tasks
GH_TOKEN=ghp_...
$ 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.
$ curl -X POST http://localhost:3000/api/projects \
-H "Content-Type: application/json" \
-d '{
"name": "my-project",
"workingDir": "/path/to/your/repo"
}'
$ 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"
}'
# 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:4200
docker compose up -d
./deploy/daemon.sh install
deploy/