PDS-Ultimate

Enterprise AI Personal Assistant for Telegram
One bot — zero buttons — full control via voice and text

Overview

PDS-Ultimate is an enterprise-grade AI assistant for managing your life and business through Telegram. A fully autonomous system with 64+ tools, offline speech recognition, intelligent task routing, and a production-ready architecture.

Unique capabilities (not found in Manus AI or similar):

Persona Engine — learns the owner's communication style from every message
Proactive Engine — works without being called (finds tasks, sets alerts automatically)
Chat Filter — filters incoming messages by owner's interests
Wide Research — parallel sub-agents + contradiction detection
Sandbox Engine — safe file/code execution with AST validation
Auto-DAG — complex tasks → execution graph → parallel execution
Self-Improvement — learns from its own mistakes automatically

Feature Matrix

Module	Description	Tech Stack
AI Engine	Reasoning + Chat, chain-of-thought, adaptive queries	DeepSeek R1
Speech-to-Text	Offline voice recognition with SRT subtitles	Vosk + Whisper
Logistics	Orders, products, tracking, statuses, anti-forgetting	SQLAlchemy + APScheduler
Finance	`INCOME - GOODS = REMAINDER - DELIVERY = NET_PROFIT`	Multi-currency USD/CNY/TMT
Calendar	Events, reminders, morning brief	Google Calendar API
Style Mimicry	Analyzes 7 TG + 3 WA chats, generates text "like you write"	Telethon + Playwright
Email Reports	Automatic reports every 3 days	Gmail API
Security	Auto-backup, code word triggers emergency wipe	SQLite + encryption
Documents	Excel, Word, PDF — create, read, parse	openpyxl + docx + PyPDF2
Browser	Playwright Pro — scraping, screenshots, automation	Playwright Chromium
Workflows	Automatic task chains, checklists	Custom engine
Analytics	Dashboards, CRM, evening digest	Analytics Dashboard
Plugins	Extensible plugin system	Plugin Manager
Production	Rate limiting, health checks, graceful shutdown	Production Hardening

Architecture

agent/pds_ultimate/
├── config.py                    # 14 frozen dataclasses, env-driven config
├── main.py                      # Entry point
│
├── core/                        # 30+ engine modules
│   ├── agent.py                 # Main ReAct loop (64+ tools)
│   ├── llm_engine.py            # DeepSeek R1 / Chat switching
│   ├── memory.py                # Short + long-term memory
│   ├── advanced_memory.py       # Working memory manager
│   ├── cognitive_engine.py      # Reasoning chains
│   ├── autonomy_engine.py       # Proactive task engine
│   ├── browser_pro.py           # Playwright browser automation
│   ├── semantic_engine.py       # Vector-based semantic search
│   ├── workflow_engine.py       # Automated task workflows
│   ├── persona_engine.py        # User style learning
│   ├── sandbox_engine.py        # Safe code/file execution
│   ├── parallel_engine.py       # Parallel sub-agent execution
│   ├── plugin_system.py         # Plugin manager
│   └── production.py            # Production hardening
│
├── bot/                         # Telegram bot layer
│   ├── handlers/                # universal, voice, files
│   ├── conversation.py          # Conversation state management
│   └── middlewares.py           # Auth, rate limiting
│
├── integrations/                # External service connectors
│   ├── google_calendar.py
│   ├── gmail.py
│   ├── telethon_client.py
│   ├── whatsapp.py
│   └── exchange_rates.py
│
├── modules/executive/           # Executive function modules
│   ├── morning_brief.py
│   ├── receipt_scanner.py
│   ├── archivist.py
│   ├── backup_security.py
│   └── translator.py
│
├── utils/                       # Helpers, formatters, validators
└── tests/                       # 2486 tests

Quick Start

Prerequisites

Python 3.12+
Docker (recommended) or manual setup
DeepSeek API key
Telegram Bot token

Docker (recommended)

cd agent
cp pds_ultimate/.env.example pds_ultimate/.env
# Edit .env with your credentials
docker compose up -d

Manual setup

cd agent/pds_ultimate
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r ../../requirements.txt
cp .env.example .env
# Edit .env with your credentials
python main.py

Configuration

Copy .env.example to .env and fill in:

TELEGRAM_BOT_TOKEN=your_token
TELEGRAM_OWNER_ID=your_user_id
DEEPSEEK_API_KEY=your_key
DEEPSEEK_BASE_URL=https://api.deepseek.com
GOOGLE_CREDENTIALS_FILE=credentials.json
VOSK_MODEL_PATH=models/vosk-model-ru

Running Tests

cd agent/pds_ultimate
pytest tests/ -v --tb=short
# 2486 tests, ~3 min

Project Structure

pds-ultimate/
├── agent/
│   ├── pds_ultimate/       # Main AI agent (this project)
│   ├── Dockerfile
│   ├── docker-compose.yml
│   └── scripts/            # deploy.sh, backup.sh
└── .github/workflows/      # CI pipeline

Tech Stack

Language: Python 3.12
Bot Framework: python-telegram-bot 21.x
LLM: DeepSeek R1 (reasoning) + DeepSeek Chat (fast)
STT: Vosk (offline) + Faster-Whisper (fallback)
Database: SQLite + SQLAlchemy
Browser Automation: Playwright Chromium
Messaging: Telethon (Telegram MTProto)
Container: Docker + Docker Compose
Testing: pytest (2486 tests)

License

MIT License — see LICENSE

Author

Ambartsumov Vyacheslav — GitHub

Обзор

PDS-Ultimate — enterprise-уровень AI-ассистент для управления жизнью и бизнесом через Telegram. Полностью автономная система с 64+ инструментами, офлайн-распознаванием речи, интеллектуальной маршрутизацией задач и production-ready архитектурой.

Уникальные возможности (аналогов нет у Manus AI и похожих систем):

Persona Engine — изучает стиль общения владельца из каждого сообщения
Proactive Engine — работает без вызова (сам находит задачи, расставляет напоминания)
Chat Filter — фильтрует входящие сообщения по интересам владельца
Wide Research — параллельные суб-агенты + обнаружение противоречий
Sandbox Engine — безопасное выполнение файлов и кода с AST-валидацией
Auto-DAG — сложные задачи → граф выполнения → параллельное исполнение
Self-Improvement — автоматически учится на своих ошибках

Таблица возможностей

Модуль	Описание	Стек
AI Engine	Reasoning + Chat, цепочки рассуждений, адаптивные запросы	DeepSeek R1
Речь в текст	Офлайн-распознавание голоса с SRT-субтитрами	Vosk + Whisper
Логистика	Заказы, товары, трек-номера, статусы, антизабывание	SQLAlchemy + APScheduler
Финансы	`ДОХОД - ТОВАРЫ = ОСТАТОК - ДОСТАВКА = ЧИСТАЯ ПРИБЫЛЬ`	Мультивалюта USD/CNY/TMT
Календарь	События, напоминания, утренний брифинг	Google Calendar API
Мимикрия стиля	Анализирует 7 TG + 3 WA чатов, генерирует текст "как ты пишешь"	Telethon + Playwright
Email-отчёты	Автоматические отчёты каждые 3 дня	Gmail API
Безопасность	Авто-бэкап, кодовое слово — экстренное удаление всего	SQLite + шифрование
Документы	Excel, Word, PDF — создание, чтение, парсинг	openpyxl + docx + PyPDF2
Браузер	Playwright Pro — парсинг, скриншоты, автоматизация	Playwright Chromium
Workflows	Автоматические цепочки задач, чеклисты	Custom engine
Аналитика	Дашборды, CRM, вечерний дайджест	Analytics Dashboard
Плагины	Расширяемая система плагинов	Plugin Manager
Production	Rate limiting, health checks, graceful shutdown	Production Hardening

Быстрый старт

Требования

Python 3.12+
Docker (рекомендуется) или ручная установка
API ключ DeepSeek
Токен Telegram бота

Docker (рекомендуется)

cd agent
cp pds_ultimate/.env.example pds_ultimate/.env
# Заполните .env своими данными
docker compose up -d

Ручная установка

cd agent/pds_ultimate
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r ../../requirements.txt
cp .env.example .env
# Заполните .env своими данными
python main.py

Конфигурация

Скопируйте .env.example в .env и заполните:

TELEGRAM_BOT_TOKEN=ваш_токен
TELEGRAM_OWNER_ID=ваш_user_id
DEEPSEEK_API_KEY=ваш_ключ
DEEPSEEK_BASE_URL=https://api.deepseek.com
GOOGLE_CREDENTIALS_FILE=credentials.json
VOSK_MODEL_PATH=models/vosk-model-ru

Запуск тестов

cd agent/pds_ultimate
pytest tests/ -v --tb=short
# 2486 тестов, ~3 мин

Структура проекта

pds-ultimate/
├── agent/
│   ├── pds_ultimate/       # Основной AI-агент (этот проект)
│   ├── Dockerfile
│   ├── docker-compose.yml
│   └── scripts/            # deploy.sh, backup.sh
└── .github/workflows/      # CI pipeline

Технологии

Язык: Python 3.12
Bot Framework: python-telegram-bot 21.x
LLM: DeepSeek R1 (рассуждения) + DeepSeek Chat (быстрые ответы)
STT: Vosk (офлайн) + Faster-Whisper (запасной)
База данных: SQLite + SQLAlchemy
Браузер: Playwright Chromium
Мессенджер: Telethon (Telegram MTProto)
Контейнеризация: Docker + Docker Compose
Тестирование: pytest (2486 тестов)

Лицензия

MIT License — см. LICENSE

Автор

Амбарцумов Вячеслав — GitHub

Built With

batchfile
dockerfile
python
shell

Updates

Ambartsumov Vyacheslav started this project — Oct 05, 2026 01:11 AM EDT

Leave feedback in the comments!

Log in or sign up for Devpost to join the conversation.