Rodrigo Rodriguez (Pragmatismo)
83fdfa6226
- Add warning that container create commands must run on HOST system - Add runtime dependencies section with install script reference - Add examples for creating vault and vectordb containers - Update troubleshooting with dependency installation instructions |
||
|---|---|---|
| .forgejo/workflows | ||
| src | ||
| .gitignore | ||
| book.toml | ||
| LICENSE | ||
| PROMPT.md | ||
| README.md | ||
General Bots
Enterprise-Grade LLM Orchestrator & AI Automation Platform
A strongly-typed, self-hosted conversational platform focused on convention over configuration and code-less approaches.
🏗️ Architecture
📦 Repositories
| Repository | Description | Status |
|---|---|---|
| botserver | Core API server - LLM orchestration, automation, integrations | ✅ Production |
| botui | Pure web UI - HTMX-based interface (suite & minimal) | ✅ Production |
| botapp | Tauri desktop wrapper - native file access, system tray | ✅ Production |
| botlib | Shared Rust library - common types, HTTP client, utilities | ✅ Production |
| bottemplates | Templates - bots, apps, prompts, UI components | ✅ Production |
| botbook | Documentation - mdBook format, multi-language | ✅ Production |
🚀 Quick Start
Prerequisites
- Rust (latest stable) - Install from rustup.rs
- Git - Download from git-scm.com
Run the Server
# Clone and run
git clone https://github.com/GeneralBots/botserver
cd botserver
cargo run
On first run, botserver automatically:
- Installs required components (PostgreSQL, S3 storage, Cache, LLM)
- Sets up database with migrations
- Downloads AI models
- Starts HTTP server at
http://127.0.0.1:8080
Run the Desktop App
# Clone botui (pure web)
git clone https://github.com/GeneralBots/botui
cd botui
cargo run # Starts web server at :3000
# In another terminal, clone and run botapp (Tauri desktop)
git clone https://github.com/GeneralBots/botapp
cd botapp
cargo tauri dev
✨ Key Features
🤖 Multi-Vendor LLM API
Unified interface for OpenAI, Groq, Claude, Anthropic, and local models.
🔧 MCP + LLM Tools Generation
Instant tool creation from code and functions - no complex configurations.
💾 Semantic Caching
Intelligent response caching achieving 70% cost reduction on LLM calls.
🌐 Web Automation Engine
Browser automation combined with AI intelligence for complex workflows.
📊 Enterprise Data Connectors
Native integrations with CRM, ERP, databases, and external services.
🔄 Git-like Version Control
Full history with rollback capabilities for all configurations and data.
🎯 4 Essential Keywords
General Bots provides a minimal, focused system:
USE KB "knowledge-base" ' Load knowledge base into vector database
CLEAR KB "knowledge-base" ' Remove KB from session
USE TOOL "tool-name" ' Make tool available to LLM
CLEAR TOOLS ' Remove all tools from session
🏛️ Architecture Details
botserver (Core)
The main API server handling:
- LLM orchestration and prompt management
- Multi-channel communication (WhatsApp, Teams, Email, Web)
- File storage and drive management
- Task scheduling and automation
- Authentication and authorization
botui (Web Interface)
Pure web UI with zero native dependencies:
- Suite: Full-featured multi-app interface
- Minimal: Lightweight single-page chat
- HTMX-powered for minimal JavaScript
- Works in any browser
botapp (Desktop)
Tauri wrapper adding native capabilities:
- Local file system access
- System tray integration
- Native dialogs and notifications
- Desktop-specific features
botlib (Shared Library)
Common Rust code shared across projects:
- HTTP client for botserver communication
- Shared types and models
- Branding and configuration utilities
- Error handling
🔧 Development Setup
# Clone all repositories
git clone https://github.com/GeneralBots/botserver botserver
git clone https://github.com/GeneralBots/botui
git clone https://github.com/GeneralBots/botapp
git clone https://github.com/GeneralBots/botlib
git clone https://github.com/GeneralBots/botbook botbook
# Build all (from each directory)
cd botlib && cargo build
cd ../botserver && cargo build
cd ../botui && cargo build
cd ../botapp && cargo build
📖 Documentation
- Complete Documentation - Full mdBook documentation
- Quick Start Guide - Get started in minutes
- API Reference - REST API documentation
- Architecture Guide - System architecture
🆚 Why General Bots?
| vs. Alternative | General Bots Advantage |
|---|---|
| ChatGPT/Claude | Automates entire business processes, not just chat |
| n8n/Make | Simpler approach with minimal programming |
| Microsoft 365 | User control, not locked ecosystems |
| Salesforce | Open-source AI orchestration connecting all systems |
🛡️ Security
- AGPL-3.0 License - True open source with contribution requirements
- Self-hosted - Your data stays on your infrastructure
- Enterprise-grade - 5+ years of stability
- No vendor lock-in - Open protocols and standards
Report security issues to: security@pragmatismo.com.br
🤝 Contributing
We welcome contributions! See our Contributing Guidelines.
Contributors
📄 License
General Bots is licensed under AGPL-3.0.
According to our dual licensing model, this program can be used either under the terms of the GNU Affero General Public License, version 3, or under a proprietary license.
Copyright (c) pragmatismo.com.br. All rights reserved.
🔗 Links
- Website: pragmatismo.com.br
- Documentation: docs.pragmatismo.com.br
- Stack Overflow: Tag questions with
generalbots - Video Tutorial: 7 AI General Bots LLM Templates
Code Name: Guaribas (a city in Brazil, state of Piauí)
"No one should have to do work that can be done by a machine." - Roberto Mangabeira Unger