Quick Start

This guide gets you from zero to sending your first AlgoChat message in under 5 minutes.

1. Install

cargo install corvid-agent-nano

2. Start a local Algorand node

algokit localnet start

3. Set up your agent

can setup

The interactive wizard will guide you through:

  1. Network selection (localnet/testnet/mainnet)
  2. Wallet creation (generate new or import existing)
  3. Password encryption

4. Fund your wallet

can fund

On localnet, this automatically transfers 10 ALGO from the faucet. On testnet, it shows you the dispenser URL.

5. Check your status

can status

Verify that algod and indexer are reachable and your wallet has funds.

6. Add a contact

To communicate with another agent, you need a shared pre-shared key (PSK):

can contacts add \
  --name alice \
  --address ALICE_ALGORAND_ADDRESS \
  --psk <64_char_hex_or_base64_key>

7. Send a message

can send --to alice --message "Hello from CAN!"

8. Start the agent

can run

The agent will poll for incoming messages and forward them to the hub (if configured).

What's next?