🦊 ApexBot

Personal AI assistant you run on your own devices. 100% Free with Ollama.

   /\   /\
  //\\_//\\  ✦ ApexBot
  \_◕ ◕_/   Local AI Assistant
   /   \   

100% Free | Open Source | Private | Local-First

✨ Features

🤖 Local AI (Ollama)

• Free - No API costs, no subscriptions
• Private - Data never leaves your machine
• Offline - Works without internet
• Models - llama3.2, mistral, qwen2.5, codellama

💬 Multi-Channel Support

| Channel | Status | Description | |---------|--------|-------------| | CLI | ✅ Ready | Terminal chat with shortcuts | | Telegram | ✅ Ready | Full bot integration | | Discord | ✅ Ready | Guilds and DMs | | WhatsApp | ✅ Ready | Via Baileys | | WebChat | ✅ Ready | Built-in dashboard | | Slack | ✅ Ready | Workspace integration | | Signal | ✅ Ready | Secure messaging | | Matrix | ✅ Ready | Decentralized chat |

🧠 Brain System

• Personality profiles (SOUL files)
• Long-term memory with LanceDB vector store
• Auto-recall - relevant memories injected into context
• Auto-capture - preferences and decisions saved automatically
• Context-aware responses
• Lobster Engine for reasoning

🔄 Model Fallback Chain

• Automatic failover between AI providers
• Tries: Ollama → Google → Anthropic
• No manual intervention needed

🛠️ 30+ Skills

| Category | Skills | |----------|--------| | Communication | Telegram, WhatsApp, Discord, Slack, Signal, iMessage, Matrix, Twitter, Gmail | | Productivity | Obsidian, Notion, Trello, GitHub, Calendar, Reminders, Apple Notes, Memory | | Media | Spotify, Sonos, Voice/TTS, Image Gen, GIF Search | | Smart Home | Home Assistant, Philips Hue | | Automation | Browser, Cron, 1Password, Weather, Search, System |

⚡ Moltbot-Style Enhancements

• Rate limiting via @grammyjs/transformer-throttler
• Typing indicators - shows "typing..." while processing
• Memory tools - memory_recall, memory_store, memory_forget

⌨️ Claude Code Style CLI

Input Prefixes: | Prefix | Action | Example | |--------|--------|---------| | ! | Bash command | !ls -la | | / | Bot commands | /help | | @ | File reference | @src/index.ts | | & | Background task | &npm test |

Keyboard Shortcuts:

• Ctrl+C - Exit
• Ctrl+L - Clear screen
• ↑↓ - History navigation
• \+Enter - Multi-line input

🌐 Web Dashboard

• Real-time chat interface
• File upload (images, code, files)
• Session management
• Channel status monitoring
• System logs

🚀 Quick Start

1. Install Ollama

# Windows
winget install Ollama.Ollama

# macOS
brew install ollama

# Linux
curl -fsSL https://ollama.com/install.sh | sh

2. Download a model

ollama pull llama3.2
ollama serve

3. Install & Run ApexBot

# Clone
git clone https://github.com/emes789/apexbot.git
cd apexbot

# Install
npm install

# Setup (interactive)
npx ts-node src/cli/index.ts onboard

# Start chat
npx ts-node src/cli/index.ts chat

📁 Project Structure

apexbot/
├── src/
│   ├── agent/        # AI agent manager
│   ├── brain/        # Personality & memory
│   ├── channels/     # Telegram, Discord, etc.
│   ├── cli/          # Terminal interface
│   ├── gateway/      # HTTP/WebSocket server
│   ├── lobster/      # Reasoning engine
│   ├── memory/       # Vector store
│   ├── sessions/     # Conversation state
│   ├── skills/       # 30+ integrations
│   ├── safety/       # Rate limiting
│   └── tools/        # Tool registry
├── scripts/          # Install scripts
└── docs/             # Documentation

⚙️ Configuration

Config file: ~/.apexbot/config.json

{
  "gateway": { "port": 18789 },
  "agent": {
    "provider": "ollama",
    "apiUrl": "http://localhost:11434",
    "model": "llama3.2",
    "enableTools": true
  },
  "channels": {
    "telegram": { "enabled": true, "token": "..." },
    "discord": { "enabled": true, "token": "..." }
  }
}

AI Providers

| Provider | Cost | Notes | |----------|------|-------| | Ollama | Free | Local, recommended, default | | Google Gemini | Free tier | Cloud API, fallback #1 | | Anthropic Claude | Paid | Cloud API, fallback #2 | | OpenAI GPT | Paid | Cloud API | | Kimi | Free tier | Cloud API |

Memory Plugin (Optional)

# Required for memory_recall/store/forget
OPENAI_API_KEY=sk-...

# Optional
MEMORY_EMBEDDING_MODEL=text-embedding-3-small
MEMORY_DB_PATH=~/.apexbot/memory/lancedb

🔧 CLI Commands

# Interactive setup
npx ts-node src/cli/index.ts onboard

# Terminal chat
npx ts-node src/cli/index.ts chat

# Start gateway server
npx ts-node src/cli/index.ts gateway

# Check status
npx ts-node src/cli/index.ts status

Chat Commands

| Command | Description | |---------|-------------| | /help | Show commands | | /status | Session info | | /reset | Clear history | | /model <name> | Switch model | | /skills | List skills | | /tools | List tools | | /fox | Show mascot 🦊 |

📊 Architecture

┌─────────────────────────────────────────────┐
│              Messaging Channels              │
│  Telegram │ Discord │ WhatsApp │ CLI │ Web  │
└────────────────────┬────────────────────────┘
                     │
┌────────────────────▼────────────────────────┐
│           Gateway Server (:18789)            │
│     HTTP API │ WebSocket │ Dashboard         │
└────────────────────┬────────────────────────┘
                     │
┌────────────────────▼────────────────────────┐
│               Orchestrator                   │
│  Sessions │ Event Bus │ Rate Limit │ Safety │
└────────────────────┬────────────────────────┘
                     │
       ┌─────────────┼─────────────┐
       ▼             ▼             ▼
┌────────────┐ ┌───────────┐ ┌──────────┐
│   Brain    │ │   Agent   │ │  Skills  │
│ Personality│ │  Manager  │ │ 30+ APIs │
│   Memory   │ │  Ollama   │ │          │
└────────────┘ └───────────┘ └──────────┘

🤝 Contributing

git clone https://github.com/emes789/apexbot.git
cd apexbot
npm install
npm run dev

See CONTRIBUTING.md for guidelines.

📄 License

MIT License. See LICENSE.

🙏 Acknowledgments

• Ported features from Clawdbot/Moltbot
  • Model fallback chain
  • Long-term memory with LanceDB
  • Rate limiting & typing indicators
• Powered by Ollama
• Built with TypeScript, grammy, discord.js