Quickstart

This guide gets you from zero to a working agent in under a minute.

1. Start the daemon

The daemon manages agents, tools, and connections in the background:

crabtalk daemon start

On first run, it creates the default configuration at ~/.crabtalk/crab.toml and scaffolds the directory structure. Use crabtalk daemon run to run in the foreground for debugging.

2. Attach to an agent

In another terminal, connect to the default "crab" agent:

crabtalk attach

You're now in an interactive REPL. Type a message and press Enter to chat.

3. Configure a model

On first run, the daemon start command prompts you to configure a model interactively. To add or edit models later:

crabtalk auth

See providers for all supported models and API standards.

What's next

• Set Up Telegram — connect a Telegram bot in 5 minutes
• Set Up Search — give your agent web search
• Configuration — customize directories, models, and services