GigaChat CLI

Текстовый интерфейс для работы с GigaChat AI через командную строку с поддержкой терминальных команд и работы с файлами.

Особенности

• Интуитивный текстовый интерфейс - современный TUI на базе Textual
• Интерактивный чат - общайтесь с GigaChat в реальном времени
• Автодополнение команд - умное автодополнение по Tab с описаниями
• Автодополнение файлов - интеллектуальное дополнение путей для терминальных команд
• Выбор моделей - переключайтесь между GigaChat 2 Lite/Pro/M
• Встроенный терминал - выполняйте системные команды прямо из чата (префикс !)
• Анализ проекта - нейросеть автоматически анализирует структуру и содержимое вашего проекта
• Работа с кодом - объяснение, рефакторинг и анализ кода с учетом контекста проекта
• История диалога - автоматическое сохранение контекста беседы
• Подсветка синтаксиса - красивый вывод кода и терминальных команд

Установка

Установка из PyPI

pip install gigachat-cli

Установка из исходного кода

git clone https://github.com/thechrismoth/GigaChat-Cli.git
cd gigachat_cli
pip install .

Настройка аутентификации

Получение API ключа

1. Перейдите на SberAI Developer Studio
2. Зарегистрируйтесь или войдите в аккаунт
3. Создайте новый API ключ

Настройка переменной окружения

export GIGACHAT_API_KEY="ваш_api_ключ_здесь"

Для постоянного хранения добавьте в ваш ~/.bashrc, ~/.zshrc или ~/.profile:

echo 'export GIGACHAT_API_KEY="ваш_api_ключ_здесь"' >> ~/.bashrc

Начало работы

Запуск приложения

gigachat

Основное использование

1. Запустите приложение - введите команду gigachat
2. Выберите "Начать чат" - из главного меню
3. Введите сообщение - пишите вопросы и нажимайте Enter для отправки
4. Используйте терминальные команды - начинайте команды с ! (например: !ls -la)
5. Используйте автодополнение - начните вводить / и используйте Tab для навигации
6. Переключайте модели* - команда /model для выбора между Lite/Pro/Max
7. Анализируйте проект - просто упомяните файлы в запросе, нейросеть автоматически их найдет
8. Выход - введите /exit чтобы закончить работу приложения

Доступные команды

• /model - выбор модели GigaChat (Lite/Pro/Max)
• /help - показать справку по командам
• /exit - выход из приложения
• /menu - возврат в меню приложения

Управление интерфейсом

• Tab / Shift+Tab - навигация по автодополнению команд
• ↑ / ↓ - навигация в выпадающих списках (селекторах)
• Enter - подтвердить выбор / отправить сообщение
• Escape - отмена / возврат / закрытие справки

Примеры использования

Базовый чат

Просто введите ваш вопрос и нажмите Shift+Enter

Терминальные команды

• !pwd - показать текущую директорию
• !python --version - проверить версию Python
• !git status - проверить статус git репозитория

Работа с проектом

• Объясни что делает main.py - автоматически найдет и проанализирует файл
• Как улучшить код в utils.py? - анализ и предложения по улучшению
• Покажи структуру проекта - анализ всей файловой структуры
• Рефакторинг функции calculate() - поиск и улучшение конкретной функции

Переключение моделей

• /model - открывает интерактивный выбор моделей

Требования

• Python >= 3.13
• GigaChat API ключ

Зависимости

• textual >= 6.2.0 - фреймворк для TUI приложений
• langchain-gigachat >= 0.3.12 - интеграция с GigaChat
• asyncio >= 4.0.0 - асинхронное программирование

Лицензия

MIT License - смотрите файл LICENSE.md для деталей.

Поддержка

Если вы столкнулись с проблемами или у вас есть предложения:

1. Создайте issue в репозитории
2. Убедитесь что GIGACHAT_API_KEY корректно установлен
3. Проверьте что Python версии 3.13 или выше

GigaChat CLI - мощный инструмент для разработчиков, сочетающий возможности AI-ассистента с удобством командной строки.