Self-Hosted-AI-Assistant

KO | EN

gitlite — search

#ai #typescript #llm #golang #go #macos #nodejs #java #windows #vue #pytorch #openai #ios #open-source

Self-Hosted-AI-Assistant

(★ 16)

Self-hosted AI assistant with WhatsApp, Telegram, Ollama, memory, tools, SQLite, and FastAPI. Built by Naboraj (Nishant)

Self-Hosted-AI-Assistant Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Self-Hosted AI Assistant

![Project Logo](https://raw.githubusercontent.com/naborajs/Self-Hosted-AI-Assistant/main/assets/logo-placeholder.png)

[![Self Hosted AI](https://img.shields.io/badge/Platform-Self%20Hosted-blue)](https://github.com/naborajs/Self-Hosted-AI-Assistant)
[![WhatsApp AI](https://img.shields.io/badge/Integration-WhatsApp-green)](https://raw.githubusercontent.com/naborajs/Self-Hosted-AI-Assistant/main/WHATSAPP_SETUP.md)
[![Telegram AI](https://img.shields.io/badge/Integration-Telegram-blue)](https://raw.githubusercontent.com/naborajs/Self-Hosted-AI-Assistant/main/TELEGRAM_SETUP.md)
[![Ollama Ready](https://img.shields.io/badge/Model-Ollama-orange)](https://raw.githubusercontent.com/naborajs/Self-Hosted-AI-Assistant/main/OLLAMA_SETUP.md)
[![License](https://img.shields.io/badge/License-MIT-lightgrey)](https://raw.githubusercontent.com/naborajs/Self-Hosted-AI-Assistant/main/LICENSE)

## 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](https://raw.githubusercontent.com/naborajs/Self-Hosted-AI-Assistant/main/assets/screenshot-whatsapp.png)
![Telegram Screenshot](https://raw.githubusercontent.com/naborajs/Self-Hosted-AI-Assistant/main/assets/screenshot-telegram.png)
![Admin UI Placeholder](https://raw.githubusercontent.com/naborajs/Self-Hosted-AI-Assistant/main/assets/screenshot-admin.png)

## Architecture Overview

```mermaid
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](./INSTALLATION.md) and [SETUP.md](./SETUP.md).

## Quick Start

1. Clone the repository:

```bash
git clone https://github.com/naborajs/Self-Hosted-AI-Assistant.git
cd Self-Hosted-AI-Assistant
```

2. Install Python dependencies:

```bash
python -m pip install -r requirements.txt
```

3. Configure your environment in `.env`.
4. Start the WhatsApp bridge:

```bash
cd whatsapp_bridge
npm install
npm start
```

5. Start the backend:

```bash
python main.py
```

6. Open `http://127.0.0.1:8000/docs` for API access.

## WhatsApp Setup

Follow the detailed guide in [WHATSAPP_SETUP.md](./WHATSAPP_SETUP.md).

## Telegram Setup

Follow the detailed guide in [TELEGRAM_SETUP.md](./TELEGRAM_SETUP.md).

## Ollama Setup

Follow the detailed guide in [OLLAMA_SETUP.md](./OLLAMA_SETUP.md).

## AI Customization

See [CUSTOMIZATION_GUIDE.md](./CUSTOMIZATION_GUIDE.md) and [PERSONALITIES.md](./PERSONALITIES.md).

## Knowledge Base

See [KNOWLEDGE_BASE.md](./KNOWLEDGE_BASE.md).

## Admin API

See [ADMIN_API.md](./ADMIN_API.md).

## Docker

See [DOCKER_GUIDE.md](./DOCKER_GUIDE.md).

## Troubleshooting

See [TROUBLESHOOTING.md](./TROUBLESHOOTING.md).

## License

This project is open source under the MIT License.

Self-Hosted-AI-Assistant

Self-Hosted-AI-Assistant Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Self-Hosted-AI-Assistant

Self-Hosted-AI-Assistant Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README