maks-mk/desktop-ai-agent

Portable Autonomous AI Agent (GUI)

English README

"Created by a SysAdmin for developers. Focus on safety, portability, and zero-nonsense execution. No Docker, no heavy environments, just one binary."

Десктопный AI-агент с runtime на LangGraph и графическим интерфейсом на PySide6.
Работает с файлами, shell-командами, процессами, MCP-серверами и веб-поиском.

Запуск из исходников: python main.py.
Сборка в portable .exe для Windows: build.bat.

---

Цель проекта

Это не AI IDE. Цель — предоставить переносимого автономного помощника, которого можно скопировать на другой компьютер и сразу использовать с минимальной настройкой.

Основные приоритеты:

• переносимость;
• безопасность;
• локальные инструменты;
• автоматизация;
• работа с файлами и локальными процессами;
• поиск информации в интернете;
• надёжность.

Проект не стремится конкурировать с AI IDE по количеству функций и не пытается заменить специализированные инструменты для разработки. Фокус — практическое выполнение повседневных задач: работа с файлами, shell-командами, локальными процессами, веб-поиском, документацией, скриптами и автоматизацией в одном переносимом приложении без сложной инфраструктуры и дополнительных сервисов.

---

Возможности

• Графовый runtime на LangGraph с bounded recovery и self-correction
• Mixed-mode parallel tool batch: read-only инструменты запускаются параллельно через asyncio.gather, остальные — последовательно; результаты собираются в исходном порядке
• GUI: история чатов, streaming transcript, tool cards, approvals, user-choice карточки, вложения
• Fuzzy replay suppression: повторный префейс модели после tool-вызова подавляется даже при минимальных расхождениях текста (опечатки, пунктуация)
• Live CLI output streaming: вывод shell-команд отображается в карточке инструмента в реальном времени, а не только после завершения
• Exit-code-neutral команды: grep, rg, vulture, `py