Skip to content

docs: refresh README features, modules and integrations [closes #13] #125

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
robotyaga-gigachain wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

docs: refresh README features, modules and integrations [closes #13] #125

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
83 changes: 56 additions & 27 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,11 +22,15 @@ GigaAgent разработан в рамках проекта [GigaChain](https:

GigaAgent умеет:

- работать с разными моделями, [доступными в LangChain](https://python.langchain.com/docs/integrations/chat/#all-chat-models): GigaChat, ChatGPT, Anthropic и другими
- исполнять код в чате с помощью в REPL-среды, подобной [блокнотам Jupyter](https://jupyter.org/)
- обмениваться данными со сторонними сервисами: VK, GitHub, 2GIS и другими
- работать с разными моделями, [доступными в LangChain](https://python.langchain.com/docs/integrations/chat/#all-chat-models): GigaChat, ChatGPT, Anthropic, DeepSeek и другими
- исполнять код в чате с помощью REPL-среды, подобной [блокнотам Jupyter](https://jupyter.org/)
- обмениваться данными со сторонними сервисами: VK, 2GIS, Яндекс.Диск, Яндекс.Почта, Яндекс.Календарь и другими
- использовать инструменты для анализа данных, генерации изображений, создания презентаций и лендингов
- генерировать изображения с помощью разных провайдеров: GigaChat, FusionBrain, OpenAI;
- проводить глубокое исследование темы (Deep Research) с планом, поиском и отчётом с цитатами
- генерировать изображения с помощью разных провайдеров: GigaChat, FusionBrain, OpenAI, Grok, Nano Banana
- планировать отложенные и периодические фоновые задачи
- группировать чаты в проекты с общими инструкциями и собственной базой знаний
- общаться с агентом из Telegram через собственного бота
- работать локально или в облаке, с помощью Docker
- использовать ваши MCP-тулы
- применять знания из ваших документов с помощью RAG
Expand Down Expand Up @@ -95,31 +99,47 @@ GigaAgent умеет:

- **Streaming Chat** — диалог с AI-агентом
- **Thread Management** — история диалогов
- **Projects** — группировка чатов в проекты с общими инструкциями и своей базой знаний (RAG)
- **Message Branching** — ветвление диалогов для экспериментов
- **File Attachments** — поддержка изображений, документов, аудио, видео
- **File Attachments** — поддержка изображений, документов, аудио, видео (drag&drop и вставка из буфера)
- **Voice Input** — голосовой ввод через SaluteSpeech (press-to-talk)
- **Chat Export** — экспорт диалога в PDF, DOCX и Markdown
- **Prompt Suggestions** — стартовые рекомендации и контекстные follow-up подсказки
- **Clarifying Questions** — агент может задавать уточняющие вопросы перед выполнением
- **Tool Visualization** — визуализация выполнения инструментов в UI
- **Generative UI Widgets** — интерактивные виджеты в чате (почта, календарь, файлы, доски задач)
- **Onboarding** — интерактивный гид по возможностям и настройкам
- **Auto-approve Mode** — автоматическое подтверждение использования инструментов
- **Stop Button** — прерывание выполнения агента

### 🔧 Встроенные модули

GigaAgent включает **13 готовых модулей** для разных задач:


| Модуль | ID | Описание |
| ------------------ | ------------------ | -------------------------------------------------------------------------------- |
| **Auth** | `auth` | Аутентификация, управление пользователями и группами |
| **REPL** | `repl` | Выполнение Python и shell команд в sandbox |
| **Image** | `image` | Генерация изображений (GigaChat, FusionBrain, OpenAI) |
| **Analyze Images** | `analyze_images` | Анализ изображений через multimodal LLM |
| **Search** | `search` | Веб-поиск через |
| **Scraper** | `scraper` | Извлечение контента с веб-страниц (Jina AI Reader) |
| **RAG** | `rag` | Retrieval Augmented Generation с векторным поиском |
| **GitHub** | `github` | Интеграция с GitHub API |
| **VK** | `vk` | Интеграция с VK API |
| **Weather** | `weather` | Получение прогноза погоды |
| **Mem0** | `mem_zero_memory` | Долговременная память агента |
| **Subagents** | `subagents_legacy` | Специализированные субагенты (landing, presentation, meme, podcast, lean_canvas) |
| **MCP** | `frontend_mcp` | Вызов MCP-тулов на стороне фронтенда пользователя |
GigaAgent включает набор готовых модулей для разных задач. Модули можно включать и
выключать в настройках; часть из них — служебные и работают всегда.

| Модуль | ID | Описание |
| --------------------- | ------------------ | ---------------------------------------------------------------------------- |
| **Песочница (REPL)** | `repl` | Выполнение Python и shell-команд в изолированной среде |
| **Файловые операции** | `io` | Чтение, запись и редактирование файлов |
| **Генерация изображений** | `image` | Создание изображений по текстовому описанию |
| **Анализ изображений**| `analyze_images` | Распознавание и описание содержимого изображений |
| **Поиск** | `search` | Поиск информации в интернете |
| **Веб-скрапер** | `scraper` | Извлечение данных с веб-страниц по URL |
| **Документы (RAG)** | `rag` | Поиск и извлечение информации из загруженных документов |
| **Deep Research** | `deep_research` | Глубокое исследование: план → поиск → чтение → синтез отчёта |
| **Отложенные задачи** | `scheduler` | Планирование отложенных и периодических фоновых задач |
| **Память** | `memory` | Долговременная память агента |
| **Навыки (Skills)** | `skills` | Использование пользовательских навыков (skill-манифестов) |
| **MCP** | `mcp` | Подключение внешних MCP-серверов и вызов их инструментов |
| **MCP (фронтенд)** | `frontend_mcp` | Вызов MCP-тулов на стороне фронтенда пользователя |
| **Погода** | `weather` | Получение прогноза погоды через OpenWeatherMap |
| **VK** | `vk` | Работа с API ВКонтакте |
| **Яндекс.Диск** | `yandex_disk` | Работа с файлами и папками на Яндекс.Диске |
| **Яндекс.Почта** | `yandex_mail` | Чтение и отправка писем в Яндекс.Почте |
| **Яндекс.Календарь** | `yandex_calendar` | Просмотр и создание событий в Яндекс.Календаре |
| **Креатив-агенты** | `subagents_legacy` | Lean Canvas, генерация мемов, подкастов, лендинги, презентации, исследование городов |
| **Проекты** | `projects` | Инструкции и база знаний уровня проекта |
| **Аутентификация** | `auth` | Аутентификация, управление пользователями и группами (служебный) |


### 🐳 Sandbox Providers
Expand Down Expand Up @@ -193,6 +213,7 @@ GigaAgent включает **13 готовых модулей** для разн

- OpenAI (GPT-4, GPT-3.5)
- GigaChat
- DeepSeek
- Anthropic (Claude)
- Любые модели через LangChain

Expand All @@ -205,12 +226,18 @@ GigaAgent включает **13 готовых модулей** для разн

- Tavily — веб-поиск
- Jina AI — web scraping
- GitHub API — работа с репозиториями
- VK API — социальная сеть
- Яндекс.Диск, Яндекс.Почта, Яндекс.Календарь — сервисы Яндекса (OAuth)
- OpenWeatherMap — прогноз погоды
- SaluteSpeech — распознавание речи для голосового ввода

**Channels:**

- Telegram — общение с агентом через собственного бота

**Vector Store:**

- Qdrant — для RAG и Mem0
- Qdrant — для RAG и памяти

### 🧪 REPL Environment

Expand All @@ -229,6 +256,8 @@ GigaAgent включает **13 готовых модулей** для разн
- GigaChat (Kandinsky)
- FusionBrain (Kandinsky)
- OpenAI (DALL-E)
- Grok (Grok Imagine)
- Nano Banana

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

Expand Down Expand Up @@ -333,8 +362,8 @@ make up_dev

### Backend

- **Python 3.11+** — современный Python с async/await
- **[LangGraph 1.0.8](https://github.com/langchain-ai/langgraph)** — state machine для AI-агентов от LangChain
- **Python 3.12** — современный Python с async/await
- **[LangGraph 1.x](https://github.com/langchain-ai/langgraph)** — state machine для AI-агентов от LangChain
- **[FastAPI](https://fastapi.tiangolo.com/)** — высокопроизводительный веб-фреймворк
- **[SQLAlchemy 2.0](https://www.sqlalchemy.org/)** — async ORM с поддержкой SQLite и PostgreSQL
- **[Alembic](https://alembic.sqlalchemy.org/)** — система миграций с multi-scope поддержкой
Expand Down