cachibot 0.2.68.dev2__tar.gz → 0.2.69.dev2__tar.gz

cachibot-0.2.69.dev2/.gitignore

@@ -0,0 +1,122 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+/lib/
+lib64/
+!frontend/src/lib/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+!cachibot-server.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# macOS
+.DS_Store
+
+# Windows
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+
+# Project specific
+cachibot.toml
+.cachibot/
+
+# Secrets
+*.pem
+*.key
+.env*
+
+error.log
+website/*
+settings.local.json
+.marketing/
+.reviews/
+settings.json
+/desktop/node_modules
+.pr/
+.plan/
+.mypy_cache/
+.ruff_cache/
+
+# Flutter / Mobile
+mobile/.dart_tool/
+mobile/.packages
+mobile/.pub-cache/
+mobile/.pub/
+mobile/build/
+mobile/.flutter-plugins
+mobile/.flutter-plugins-dependencies
+mobile/android/.gradle/
+mobile/android/local.properties
+mobile/android/**/GeneratedPluginRegistrant.java
+mobile/android/key.properties
+mobile/android/**/*.keystore
+mobile/android/**/*.jks
+mobile/ios/Flutter/Generated.xcconfig
+mobile/ios/Flutter/flutter_export_environment.sh
+mobile/ios/Runner/GeneratedPluginRegistrant.*
+mobile/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-*.png
+mobile/ios/Pods/
+mobile/.fvm/
+*.iml
+pr.md
+*.tsbuildinfo

cachibot-0.2.69.dev2/PKG-INFO

@@ -0,0 +1,384 @@
+Metadata-Version: 2.4
+Name: cachibot
+Version: 0.2.69.dev2
+Summary: The Armored AI Agent. Cross-platform, secure, yours.
+Project-URL: Homepage, https://cachibot.ai
+Project-URL: Documentation, https://cachibot.ai/docs
+Project-URL: Repository, https://github.com/jhd3197/cachibot
+Project-URL: Issues, https://github.com/jhd3197/cachibot/issues
+Author-email: Juan Denis <juan@vene.co>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,ai,automation,llm,python,sandbox,security
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: aiofiles>=24.1.0
+Requires-Dist: aiogram>=3.0.0
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: alembic>=1.13.0
+Requires-Dist: asyncpg>=0.29.0
+Requires-Dist: bcrypt>=4.0.0
+Requires-Dist: botbuilder-core>=4.14.0
+Requires-Dist: botbuilder-integration-aiohttp>=4.14.0
+Requires-Dist: croniter>=2.0.0
+Requires-Dist: cryptography>=42.0.0
+Requires-Dist: discord-py>=2.0.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: fastembed>=0.4.0
+Requires-Dist: pgvector>=0.3.0
+Requires-Dist: prompture>=1.0.43
+Requires-Dist: pydantic[email]>=2.9.0
+Requires-Dist: pyjwt>=2.8.0
+Requires-Dist: pymupdf>=1.26.0
+Requires-Dist: python-docx>=1.1.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: rich>=13.0.0
+Requires-Dist: slack-bolt>=1.18.0
+Requires-Dist: slack-sdk>=3.27.0
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0
+Requires-Dist: tukuy>=0.0.30
+Requires-Dist: typer>=0.12.0
+Requires-Dist: uvicorn[standard]>=0.32.0
+Requires-Dist: websockets>=14.0
+Provides-Extra: dev
+Requires-Dist: bandit>=1.7.0; extra == 'dev'
+Requires-Dist: mypy>=1.10.0; 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
+
+<div align="center">
+  <img src="assets/hero.png" alt="CachiBot" width="800" />
+
+  <h1>CachiBot</h1>
+
+  <p><strong>The Armored AI Agent</strong></p>
+  <p><em>Visual. Transparent. Secure.</em></p>
+
+  <p>
+    <a href="https://cachibot.ai">Website</a> ·
+    <a href="https://codewiki.google/github.com/jhd3197/cachibot">CodeWiki</a> ·
+    <a href="docs/README.es.md">Español</a> ·
+    <a href="docs/README.zh-CN.md">中文版</a> ·
+    <a href="docs/README.pt.md">Português</a>
+  </p>
+
+  <p>
+    <img src="https://img.shields.io/badge/Windows-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="Windows" />
+    <img src="https://img.shields.io/badge/macOS-000000?style=for-the-badge&logo=apple&logoColor=white" alt="macOS" />
+    <img src="https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black" alt="Linux" />
+  </p>
+
+  <p>
+    <a href="https://pypi.org/project/cachibot"><img src="https://img.shields.io/pypi/v/cachibot.svg" alt="PyPI" /></a>
+    <a href="https://pypi.org/project/cachibot"><img src="https://img.shields.io/pypi/dm/cachibot.svg" alt="Downloads" /></a>
+    <a href="https://github.com/jhd3197/CachiBot/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License" /></a>
+    <a href="https://python.org"><img src="https://img.shields.io/badge/Python-3.10+-blue.svg" alt="Python" /></a>
+    <a href="https://react.dev"><img src="https://img.shields.io/badge/React-19-61DAFB.svg" alt="React" /></a>
+    <a href="https://github.com/jhd3197/CachiBot/stargazers"><img src="https://img.shields.io/github/stars/jhd3197/CachiBot?style=social" alt="Stars" /></a>
+    <a href="https://discord.gg/93QEWZeHRK"><img src="https://img.shields.io/discord/1470624345188732992?label=Discord&logo=discord&logoColor=white&color=5865F2" alt="Discord" /></a>
+  </p>
+
+  <p>
+    A visual AI agent platform with full transparency. Named after the Venezuelan <em>cachicamo</em> (armadillo) — built to be armored, auditable, and yours to control.
+  </p>
+
+  <p>
+    <a href="#install">Install</a> ·
+    <a href="#features">Features</a> ·
+    <a href="#supported-providers">Providers</a> ·
+    <a href="#security">Security</a> ·
+    <a href="#contributing">Contributing</a> ·
+    <a href="https://discord.gg/93QEWZeHRK">Discord</a>
+  </p>
+
+</div>
+
+---
+
+## Why CachiBot?
+
+Most AI platforms force you to choose: chatbot UIs with no automation, workflow builders with no conversational AI, or developer frameworks that take weeks to ship.
+
+**CachiBot gives you all three.** Build specialized bots, deploy them to any messaging platform, run them in collaborative rooms, and automate workflows — all from a visual dashboard with full transparency into what your agents are doing.
+
+
+![arepa-war](https://github.com/user-attachments/assets/5996fc02-0c4c-4a61-a998-f007189494fd)
+
+<p align="center">
+  <a href="https://youtu.be/G8JEhkcRxD8">
+    <img src="https://img.shields.io/badge/YouTube-Watch_Demo-red?style=for-the-badge&logo=youtube&logoColor=white" alt="Watch on YouTube" />
+  </a>
+  <a href="https://cachibot.ai/marketplace/rooms/great-arepa-war?utm_source=github&utm_medium=readme&utm_campaign=arepa_war_room">
+    <img src="https://img.shields.io/badge/CachiBot-View_Room-blue?style=for-the-badge&logo=google-chrome&logoColor=white" alt="View the Chat on CachiBot" />
+  </a>
+  <a href="https://dev.to/juandenis/ai-settles-the-ultimate-venezuelan-vs-colombian-arepa-debate-2ngm">
+    <img src="https://img.shields.io/badge/Dev.to-Read_Article-0A0A0A?style=for-the-badge&logo=devdotto&logoColor=white" alt="Read on Dev.to" />
+  </a>
+</p>
+
+## Install
+
+### Linux / macOS
+
+```bash
+curl -fsSL cachibot.ai/install.sh | bash
+```
+
+Sets up Python, a virtual environment, and a systemd service — everything you need in one command.
+
+### Windows
+
+```powershell
+irm cachibot.ai/install.ps1 | iex
+```
+
+### pip
+
+```bash
+pip install cachibot
+```
+
+Then start the server:
+
+```bash
+cachibot server
+```
+
+Open **http://localhost:5870** — the frontend is bundled and served automatically. No separate build step.
+
+### Docker
+
+```bash
+docker compose up
+```
+
+### Desktop App
+
+Download the installer for your platform from [GitHub Releases](https://github.com/jhd3197/CachiBot/releases). Available as NSIS installer (Windows), DMG (macOS), and AppImage/DEB/RPM (Linux). Includes auto-update.
+
+### Configure your API keys
+
+You can set API keys directly from the dashboard UI — no environment variables required. Just open the settings panel and add your keys there.
+
+If you prefer environment variables, those work too:
+
+```bash
+export OPENAI_API_KEY="your-key"       # OpenAI / GPT-4
+export ANTHROPIC_API_KEY="your-key"    # Claude
+export MOONSHOT_API_KEY="your-key"     # Kimi
+# or use Ollama locally (no key needed)
+```
+
+### CLI Usage
+
+```bash
+cachibot server                    # Start the dashboard
+cachibot "summarize this project"  # Run a single task
+cachibot                           # Interactive mode
+cachibot --model claude/sonnet     # Override model
+cachibot --workspace ./my-project  # Set workspace
+cachibot --approve                 # Require approval for each action
+cachibot --verbose                 # Show thinking process
+cachibot diagnose                  # Check installation health
+cachibot repair                    # Fix corrupted installation
+cachi server                       # Short alias
+```
+
+## Features
+
+### Multi-Agent Platform
+
+- **Unlimited Specialized Bots** — Create bots with custom system prompts, per-bot model routing, capability toggles, and isolated API keys per provider
+- **Collaborative Rooms** — Run multiple bots together with 9 response modes: parallel, sequential, chain, router, debate, waterfall, relay, consensus, and interview
+- **Bot Marketplace** — Pre-built bot and room templates for common use cases, installable from the dashboard
+
+### Capability-Gated Plugin System
+
+Every bot has a set of capability toggles that control which tools are available. Plugins are loaded dynamically based on these toggles, powered by [Tukuy](https://github.com/jhd3197/Tukuy):
+
+| Capability | Tools |
+|-----------|-------|
+| Code Execution | Sandboxed Python with AST risk analysis |
+| File Operations | Read, write, edit, list, info — scoped to workspace |
+| Git Operations | Status, diff, log, commit, branch |
+| Shell Access | Shell commands with security restrictions |
+| Web Access | Fetch URLs, search the web, HTTP requests |
+| Data Operations | SQLite queries, zip/tar compression |
+| Work Management | Tasks, todos, jobs, functions, schedules |
+| Image Generation | DALL-E, Google Imagen, Stability AI, Grok |
+| Audio Generation | OpenAI TTS, ElevenLabs, Whisper transcription |
+| Coding Agents | Spawn Claude Code, OpenAI Codex, or Gemini CLI as sub-agents |
+| Knowledge Base | Semantic search across uploaded documents and notes |
+| Custom Instructions | LLM-powered instruction packs (analysis, writing, developer) |
+
+### Platform Integrations
+
+Deploy bots to **7 messaging platforms** with built-in adapters. Connections are stored encrypted, auto-reconnected on server restart, and health-monitored:
+
+Telegram · Discord · Slack · Microsoft Teams · WhatsApp · Viber · LINE
+
+### Knowledge Base & RAG
+
+- Upload documents (PDF, TXT, MD, DOCX) — automatically chunked and embedded
+- Vector similarity search with configurable chunk size, overlap, and relevance threshold
+- Embedding providers: OpenAI, Ollama, or local FastEmbed (no API key needed)
+- Freeform notes as an additional knowledge source
+- Storage: SQLite with cosine similarity or PostgreSQL with pgvector
+
+### Work Management & Automation
+
+- **Work Items** — Top-level units with status tracking (pending, in progress, completed, failed, cancelled, paused)
+- **Tasks** — Steps within work items with dependency tracking and automatic blocking/unblocking
+- **Jobs** — Background agent executions, managed by a job runner service with real-time WebSocket progress
+- **Todos** — Lightweight checklist items
+- **Functions** — Reusable task templates with typed parameters and step-level dependencies
+- **Schedules** — Cron, interval, once, or event-triggered execution of functions
+- **Scripts** — Python scripts with version history, Monaco editor, and a separate execution sandbox
+
+### Voice Conversations
+
+Talk to your bots with real-time speech-to-text and text-to-speech through a dedicated voice interface.
+
+### OpenAI-Compatible API
+
+CachiBot exposes `/v1/chat/completions` and `/v1/models` endpoints, so external tools like Cursor or VS Code extensions can use your bots as if they were OpenAI models. Authenticated with `cb-*` API keys from the developer panel. Supports streaming via SSE.
+
+### Security & Control
+
+- **Visual Approval Flows** — Approve or reject risky operations before they execute
+- **Sandboxed Execution** — Python runs in isolation with AST-based risk scoring (SAFE / MODERATE / DANGEROUS)
+- **Workspace Isolation** — All file access scoped to the workspace
+- **Encrypted Credentials** — Platform connection secrets stored with AES encryption
+- **Full Audit Trail** — Every action logged with timing, token usage, and cost
+
+### Authentication & Access Control
+
+- JWT-based auth with access and refresh tokens
+- Self-hosted mode with local user management via setup wizard
+- User roles (admin, user) with bot ownership and group-based access control
+- Rate limiting on auth endpoints
+
+## What Can You Build?
+
+- **Customer Support Bot** — Deploy to Telegram with a knowledge base of your docs, auto-answer FAQs
+- **Data Analysis Room** — 3 bots (SQL specialist + Python analyst + report writer) collaborating on insights
+- **Voice Assistant** — Talk to a bot with STT/TTS, manage tasks and reminders hands-free
+- **Content Pipeline** — Research bot + writer bot + image generator producing blog posts end-to-end
+- **DevOps Agent** — Monitor repos, run sandboxed scripts, send alerts to Slack on schedule
+- **Coding Assistant** — Bot that spawns Claude Code or Codex to handle complex coding tasks
+
+## Supported Providers
+
+CachiBot uses [Prompture](https://github.com/jhd3197/Prompture) for model management with auto-discovery — set an API key and available models appear automatically.
+
+| Provider | Example Models | Environment Variable |
+|----------|---------------|---------------------|
+| OpenAI | GPT-4o, GPT-4, o1 | `OPENAI_API_KEY` |
+| Anthropic | Claude Sonnet, Opus, Haiku | `ANTHROPIC_API_KEY` |
+| Moonshot | Kimi K2.5 | `MOONSHOT_API_KEY` |
+| Google | Gemini Pro, Flash | `GOOGLE_API_KEY` |
+| Groq | Llama 3, Mixtral | `GROQ_API_KEY` |
+| Grok / xAI | Grok-2 | `GROK_API_KEY` |
+| OpenRouter | Any model on OpenRouter | `OPENROUTER_API_KEY` |
+| Azure OpenAI | GPT-4, GPT-4o | `AZURE_OPENAI_API_KEY` |
+| ZhipuAI | GLM-4 | `ZHIPUAI_API_KEY` |
+| ModelScope | Qwen | `MODELSCOPE_API_KEY` |
+| Stability AI | Stable Diffusion (image gen) | `STABILITY_API_KEY` |
+| ElevenLabs | Voice synthesis | `ELEVENLABS_API_KEY` |
+| Ollama | Any local model | *(no key needed)* |
+| LM Studio | Any local model | *(no key needed)* |
+
+All keys can also be configured from the dashboard UI without touching environment variables.
+
+## Security
+
+CachiBot is built with security as a core principle. **Visibility is security** — the biggest risk with AI agents is not knowing what they're doing.
+
+### Sandboxed Execution
+
+Python code runs in a restricted environment:
+
+- **Import Restrictions** — Only safe modules allowed (json, math, datetime, etc.)
+- **Path Restrictions** — File access limited to the workspace via SecurityContext
+- **Execution Timeout** — Code killed after timeout (default: 30s)
+- **Risk Analysis** — AST-based scoring (SAFE / MODERATE / DANGEROUS) before execution
+- **Approval Flow** — Dangerous operations require explicit approval through the dashboard
+
+### Always Blocked
+
+These are never allowed regardless of configuration: `subprocess`, `os.system`, `ctypes`, `socket`, `ssl`, `importlib`, `eval`, `exec`, `pickle`, `marshal`.
+
+## Configuration
+
+CachiBot supports layered configuration: environment variables override workspace TOML, which overrides user `~/.cachibot.toml`, which overrides defaults. See [`cachibot.example.toml`](cachibot.example.toml) for all options.
+
+Key sections: `[agent]` (model, temperature, max iterations), `[sandbox]` (allowed imports, timeout), `[knowledge]` (chunk size, embedding model, similarity threshold), `[coding_agents]` (default agent, timeout, CLI paths), `[database]` (SQLite or PostgreSQL URL), `[auth]` (JWT settings).
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide. Quick start:
+
+```bash
+git clone https://github.com/jhd3197/CachiBot.git
+cd CachiBot
+
+# Backend
+python -m venv venv && source venv/bin/activate  # or .\venv\Scripts\activate on Windows
+pip install -e ".[dev]"
+
+# Frontend
+cd frontend && npm install && cd ..
+
+# Desktop (optional — only if working on the Electron shell)
+cd desktop && npm install && cd ..
+
+# Run everything
+bash dev.sh              # or .\dev.ps1 on Windows
+bash dev.sh desktop      # with Electron
+bash dev.sh watch-lint   # lint watcher (ruff + ESLint on save)
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for all dev script modes, project structure, testing, and code style guidelines.
+
+## Community
+
+<p align="center">
+  <a href="https://cachibot.ai">
+    <img src="https://img.shields.io/badge/Website-cachibot.ai-blue?style=for-the-badge&logo=google-chrome&logoColor=white" alt="Website" />
+  </a>
+  <a href="https://discord.gg/93QEWZeHRK">
+    <img src="https://img.shields.io/badge/Discord-Join_the_community-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord" />
+  </a>
+  <a href="https://github.com/jhd3197/CachiBot/issues">
+    <img src="https://img.shields.io/badge/Issues-Report_a_bug-red?style=for-the-badge&logo=github&logoColor=white" alt="Issues" />
+  </a>
+</p>
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+## Credits
+
+- Built with [Prompture](https://github.com/jhd3197/Prompture) for structured LLM interaction and multimodal drivers
+- Plugin system powered by [Tukuy](https://github.com/jhd3197/Tukuy)
+- Named after the Venezuelan *cachicamo* (armadillo)
+
+---
+
+<p align="center">
+  Made with care by <a href="https://juandenis.com">Juan Denis</a>
+</p>