Quickstart

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

1. Start chatting

Just run crabtalk:

crabtalk

On first run, it scaffolds the config directory at ~/.crabtalk/, prompts you to configure a model, starts the daemon in the background, and drops you into an interactive REPL. Type a message and press Enter to chat.

2. Manage the daemon

The daemon runs as a background service. You can manage it explicitly:

crabtalk --start       # start daemon without entering chat
crabtalk --stop        # stop daemon
crabtalk --restart     # restart daemon
crabtalk --foreground  # run in foreground (for debugging)
crabtalk --reload      # hot-reload config

3. Configure models

To add or edit model providers later:

crabtalk config

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