nullabot 1.0.1__tar.gz

nullabot-1.0.1/.claude/settings.local.json

@@ -0,0 +1,25 @@
+{
+  "permissions": {
+    "allow": [
+      "WebSearch",
+      "Bash(chmod:*)",
+      "Bash(source:*)",
+      "Bash(pip install:*)",
+      "Bash(python:*)",
+      "Bash(nullabot --help:*)",
+      "Bash(TELEGRAM_BOT_TOKEN=\"8414738778:AAGhM92DFJPo7n7bUQbOIcVcd4rZcKIHHO0\" timeout 5 nullabot:*)",
+      "Bash(TELEGRAM_BOT_TOKEN=\"8414738778:AAGhM92DFJPo7n7bUQbOIcVcd4rZcKIHHO0\" python -c \"\nfrom nullabot.cli import cli\nimport sys\n# Just test import and setup, don''t actually run\nfrom nullabot.bot.telegram import TelegramBot\nprint\\(''✓ Bot module imports OK''\\)\nprint\\(''✓ Ready to run''\\)\n\")",
+      "Bash(grep:*)",
+      "Bash(pkill:*)",
+      "Bash(find:*)",
+      "Bash(python3 -m py_compile:*)",
+      "Bash(kill:*)",
+      "Bash(claude -p \"/usage\" --output-format json)",
+      "Bash(claude -p \"what is my current usage and limits?\" --output-format json)",
+      "Bash(pgrep:*)",
+      "Bash(lsof +D:*)",
+      "Bash(python3:*)",
+      "Bash(pip3 install:*)"
+    ]
+  }
+}

nullabot-1.0.1/.gitignore

@@ -0,0 +1,57 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Project files
+projects/
+users/
+global_window.json
+*.db
+
+# Config with secrets
+config.yaml
+config.local.yaml
+.env
+.env.*
+
+# Logs
+logs/
+*.log
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Plan file (development)
+PLAN.md

nullabot-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ebokoo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nullabot-1.0.1/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: nullabot
+Version: 1.0.1
+Summary: 24/7 AI agents that think, design, and code - controlled via Telegram
+Project-URL: Homepage, https://github.com/ebokoo/nullabot
+Project-URL: Repository, https://github.com/ebokoo/nullabot
+Project-URL: Issues, https://github.com/ebokoo/nullabot/issues
+Author: ebokoo
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,ai,automation,bot,claude,coding,telegram
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.11
+Requires-Dist: aiofiles>=23.0.0
+Requires-Dist: aiosqlite>=0.19.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-telegram-bot>=21.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: watchdog>=4.0.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.5.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# 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)
+   ```bash
+   npm install -g @anthropic-ai/claude-code
+   claude login
+   ```
+
+## Install
+
+```bash
+pip install nullabot
+nullabot setup
+```
+
+The setup wizard asks for:
+- **Bot token** - Create at [@BotFather](https://t.me/BotFather) on Telegram
+- **Your user ID** - Get from [@userinfobot](https://t.me/userinfobot) on Telegram
+- **Other users** (optional) - Friends who can use your bot
+
+## Start the Bot
+
+```bash
+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
+
+```bash
+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
+
+```bash
+# Manual (stops when terminal closes)
+./run_nullabot.sh bot
+
+# Auto-start on Mac login
+./setup_autostart.sh
+```
+
+## License
+
+MIT

nullabot-1.0.1/README.md

@@ -0,0 +1,95 @@
+# 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)
+   ```bash
+   npm install -g @anthropic-ai/claude-code
+   claude login
+   ```
+
+## Install
+
+```bash
+pip install nullabot
+nullabot setup
+```
+
+The setup wizard asks for:
+- **Bot token** - Create at [@BotFather](https://t.me/BotFather) on Telegram
+- **Your user ID** - Get from [@userinfobot](https://t.me/userinfobot) on Telegram
+- **Other users** (optional) - Friends who can use your bot
+
+## Start the Bot
+
+```bash
+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
+
+```bash
+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
+
+```bash
+# Manual (stops when terminal closes)
+./run_nullabot.sh bot
+
+# Auto-start on Mac login
+./setup_autostart.sh
+```
+
+## License
+
+MIT

nullabot-1.0.1/config.example.yaml

@@ -0,0 +1,29 @@
+# Nullabot Configuration Example
+# Run "nullabot setup" to generate this automatically
+
+telegram:
+  # Your bot token (from @BotFather)
+  bot_token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
+
+  # Admin user ID - can see all projects, approve users (from @userinfobot)
+  admins:
+    - 123456789
+
+  # Additional allowed users (optional - can also use /approve command)
+  allowed_users:
+    - 987654321
+    - 555555555
+
+agent:
+  model: opus
+  timeout: 1800
+  max_errors: 3
+
+reliability:
+  plan: max_200
+  exit_detection:
+    enabled: true
+    max_cycles: 100
+
+paths:
+  projects_dir: ./projects

nullabot-1.0.1/nullabot/__init__.py

@@ -0,0 +1,3 @@
+"""Nullabot - 24/7 AI Workforce"""
+
+__version__ = "0.1.0"

nullabot-1.0.1/nullabot/agents/__init__.py

@@ -0,0 +1,7 @@
+"""Nullabot Agents - Uses Claude Code CLI"""
+
+from nullabot.agents.claude_agent import ClaudeAgent
+
+__all__ = [
+    "ClaudeAgent",
+]