Super Agent 🤖

AI агент с потоковым выполнением команд и Docker песочницей для безопасного выполнения.

🚀 Возможности

• Потоковое выполнение - команды выполняются во время генерации ответа AI
• Docker песочница - безопасное изолированное выполнение команд
• Компактный формат - специальный § формат для экономии токенов (5-6x)
• OpenRouter API - поддержка множества моделей AI
• Итеративное выполнение - автоматические попытки при ошибках
• Контекстуальная память - сохранение истории и активных файлов

📋 Требования

• Node.js 14+
• Docker (WSL2 на Windows)
• OpenRouter API ключ

🔧 Установка

1. Клонируйте репозиторий:

git clone https://github.com/your-username/super-agent2.git
cd super-agent2

2. Установите зависимости:

npm install

3. Настройте Docker (для Windows через WSL2):

# В WSL2 Ubuntu
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

4. Скопируйте и настройте .env:

cp .env.example .env
# Добавьте ваш OPENROUTER_API_KEY

🎮 Использование

Интерактивный режим

npm start

Пример взаимодействия

🤖 Super Agent v1.0.0
💬 Введите задачу или "exit" для выхода

Задача> Создать Express сервер с API для управления задачами
Цель> Работающий REST API с CRUD операциями для задач

🔄 1:
⚙️ Выполнение: §💻 npm init -y...
⚙️ Выполнение: §💻 npm install express...
⚙️ Выполнение: §📝 server.js...
⚙️ Выполнение: §💻 node server.js...

✅ Задача выполнена успешно!

Просмотр доступных моделей

npm run models

🤝 § Формат команд

Агент использует специальный формат для команд:

• §📖file.js - прочитать файл
• §📝file.js - создать файл
• §✏️file.js - редактировать файл
• §💻command - выполнить shell команду
• §✅ - задача выполнена
• §❌reason - задача провалена
• §❓question - вопрос к пользователю

🔒 Безопасность

Все команды выполняются в изолированном Docker контейнере:

• Доступ только к папке проекта
• Ограничение ресурсов (1GB RAM, 50% CPU)
• Выполнение от непривилегированного пользователя
• Таймаут 30 секунд на команду
• Фильтрация опасных команд

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

.env файл:

# OpenRouter API
OPENROUTER_API_KEY=your_key_here

# Модель AI
AI_MODEL=x-ai/grok-4-fast:free

# Параметры генерации
TEMPERATURE_STAGE1=0.5
TEMPERATURE_STAGE2=0.6
MAX_TOKENS=20000
REASONING_ENABLED=true
REASONING_EFFORT=high

# Настройки агента
DEBUG=true
MAX_ITERATIONS=16
TIMEOUT_MS=60000
MEMORY_TASKS=20

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

super-agent2/
├── src/
│   ├── agent.js           # Главный класс агента
│   ├── openrouter-client.js # Клиент для OpenRouter API
│   └── docker-executor.js  # Docker песочница
├── prompts/
│   └── system.txt         # Системный промпт
├── scripts/
│   └── list-models.js     # Список доступных моделей
├── docs/
│   ├── AGENT_FORMAT.md    # Документация § формата
│   ├── AI_REQUEST_FORMAT.md # Формат запросов к AI
│   ├── DOCKER_SANDBOX.md  # Docker песочница
│   └── AI_AGENT_ARCHITECTURE.md # Архитектура
├── .env                   # Конфигурация
├── package.json           # Зависимости
└── README.md             # Этот файл

🏗️ Архитектура

User Input → Agent → OpenRouter API
                ↓
          Stream Response
                ↓
        Command Detection
                ↓
         Docker Sandbox
                ↓
        Execute & Continue

📊 Производительность

• Потоковое выполнение: 5-7 секунд вместо 15
• Экономия токенов: 5-6x меньше благодаря § формату
• Параллельность: команды выполняются во время генерации

🐛 Отладка

Включите DEBUG в .env для подробных логов:

DEBUG=true

📄 Лицензия

MIT

👥 Вклад

Pull requests приветствуются!