Skip to main content

24/7 AI agents that think, design, and code - controlled via Telegram

Project description

Nullabot

24/7 AI agents that think, design, and code - controlled via Telegram.

Requirements

  1. Python 3.11+
  2. Claude Code CLI (requires Claude Max subscription ~$100-200/month)
    npm install -g @anthropic-ai/claude-code
    claude login
    

Install

pip install nullabot
nullabot setup

The setup wizard asks for:

  • Bot token - Create at @BotFather on Telegram
  • Your user ID - Get from @userinfobot on Telegram
  • Other users (optional) - Friends who can use your bot

Start the Bot

nullabot bot

Now open Telegram and message your bot!

Telegram Commands

Command Description
/start Show main menu
/usage Show project costs
/rules View/add global rules
/chat <question> Ask anything
/help All commands

Admin commands:

Command Description
/users List all users
/approve <id> Approve a user
/revoke <id> Remove user

CLI Commands

nullabot new myproject              # Create project
nullabot think myproject "task"     # Research agent
nullabot design myproject "task"    # Design agent
nullabot code myproject "task"      # Coding agent
nullabot projects                   # List projects
nullabot usage                      # Show costs

Three Agents

Agent What it does
Thinker Research, analyze, brainstorm
Designer UI/UX specs, component design
Coder Write code, tests, docs

Agents automatically hand off context to each other.

Global Rules

Tell agents what to always/never do:

/rules add do Always use TypeScript
/rules add dont Never use console.log

Or just say it naturally in any message - it auto-saves!

Run 24/7

# Manual (stops when terminal closes)
./run_nullabot.sh bot

# Auto-start on Mac login
./setup_autostart.sh

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nullabot-1.1.1.tar.gz (62.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nullabot-1.1.1-py3-none-any.whl (66.9 kB view details)

Uploaded Python 3

File details

Details for the file nullabot-1.1.1.tar.gz.

File metadata

  • Download URL: nullabot-1.1.1.tar.gz
  • Upload date:
  • Size: 62.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for nullabot-1.1.1.tar.gz
Algorithm Hash digest
SHA256 a32a7ee2b5e65caa90e2e62b684c4a91071dc0bad41436eb1b09e4130bbf659c
MD5 88beda626d10e0635d88e5b9851c9c4e
BLAKE2b-256 0aca7221b2a6246641660efaf81857c9b5845f9bbe5c40bd3a5ae8b82a0b1113

See more details on using hashes here.

File details

Details for the file nullabot-1.1.1-py3-none-any.whl.

File metadata

  • Download URL: nullabot-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 66.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for nullabot-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 de33a525359897158e416ea7e4d026bd27b26b729b75ab2ec665bf3b3ce8ce23
MD5 031d152c798c44aad25bf5d252778ded
BLAKE2b-256 207ddc584890eba076dee85dcbb57fec1bd37dcf5cd115b4bee679bc664a359e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page