Self-Hosted-AI-Assistant/main/assets/logo-placeholder.png" alt="Project Logo">

Project Banner

A privacy-first, local AI assistant platform for WhatsApp, Telegram, and Ollama. Configure behavior, train the model with knowledge, manage personalities, and control memory — all without touching code.

Features

  • Local Ollama-powered AI inference
  • WhatsApp companion device bridge integration
  • Telegram chat gateway support
  • AI identity and personality management
  • Global and platform-specific system prompts
  • Preset reply engine with exact, keyword, and regex match
  • Knowledge base and training import system
  • Memory management for short-term and long-term context
  • Admin API for runtime configuration
  • Backup and restore for AI state
  • Secure admin access and health monitoring

Screenshots

Replace these placeholders with real screenshots after setup.

WhatsApp Screenshot Telegram Screenshot Admin UI Placeholder

Architecture Overview

flowchart TD
    subgraph Backend
      A[FastAPI API] --> B[AI Manager]
      A --> C[WhatsApp Gateway]
      A --> D[Telegram Gateway]
      A --> E[Memory Store]
      B --> F[Storage Files]
      B --> G[Knowledge Base]
      B --> H[System Prompts]
    end
    subgraph Local AI
      I[Ollama] --> A
    end
    subgraph External
      C --> J[WhatsApp Bridge]
      D --> K[Telegram API]
    end

Installation

See INSTALLATION.md and SETUP.md.

Quick Start

  1. Clone the repository:
git clone https://github.com/naborajs/Self-Hosted-AI-Assistant.git
cd Self-Hosted-AI-Assistant
  1. Install Python dependencies:
python -m pip install -r requirements.txt
  1. Configure your environment in .env.
  2. Start the WhatsApp bridge:
cd whatsapp_bridge
npm install
npm start
  1. Start the backend:
python main.py
  1. Open http://127.0.0.1:8000/docs for API access.

WhatsApp Setup

Follow the detailed guide in WHATSAPP_SETUP.md.

Telegram Setup

Follow the detailed guide in TELEGRAM_SETUP.md.

Ollama Setup

Follow the detailed guide in OLLAMA_SETUP.md.

AI Customization

See CUSTOMIZATION_GUIDE.md and PERSONALITIES.md.

Knowledge Base

See KNOWLEDGE_BASE.md.

Admin API

See ADMIN_API.md.

Docker

See DOCKER_GUIDE.md.

Troubleshooting

See TROUBLESHOOTING.md.