V E I N   C L A W   v5.0

VEINClaw — это автономный AI-агент v5.0 и оркестратор контекста, построенный на базе Google Gemini 2.0 Flash. Проект спроектирован как ядро для управления рабочими процессами экосистемы VEIN. Система использует паттерны Tool-calling и замкнутый цикл Action-Observation для решения бэкенд-задач, мониторинга и работы с внешними API.

⚡ Ключевые архитектурные решения

1. Autonomous Mission Mode: Агент способен планировать и выполнять сложные цепочки задач (миссии), самостоятельно оценивая прогресс и корректируя действия.

2. Visual Intelligence (Vision Suite): Прямой визуальный анализ UI-интерфейсов и видео через Gemini Vision для контроля работоспособности фронтенда.

3. Smart Refactoring: Глубокий рефакторинг нескольких файлов одновременно с учетом архитектурного контекста всего проекта.

4. Self-Maintenance & Self-Healing: Автоматическая проверка зависимостей, очистка системы и исправление собственных ошибок в коде.

5. Context Architecture & Long-term Memory (RAG): Динамическое управление памятью через ChromaDB и memory.json.

6. Dynamic Tool Discovery (MCP approach): Инструменты подхватываются на лету, позволяя расширять возможности агента без остановки системы.

🛠 Технологический стек

• Core: Python 3.10+, Subprocess API
• LLM Orchestrator: google-genai (Gemini 2.0 Flash)
• API & Auth: google-api-python-client, google-auth-oauthlib, GitHub SDK
• Vector DB: ChromaDB (RAG)
• Automation: Playwright (Vision/Web)
• Utilities: psutil, python-dotenv, duckduckgo_search

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

• main.py — Точка входа, оркестратор и цикл взаимодействия (LLM Routing).
• actions.py — Пул изолированных инструментов (tools) для вызова моделью.
• requirements.txt — Фиксированные зависимости.
• .env.example — Шаблон конфигурации среды.

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

1. Клон репозитория и настройка окружения:

   git clone https://github.com/Peaostrel/VEINClaw.git
   cd VEINClaw
   python -m venv venv

   Windows:

   venv\Scripts\activate

   Linux/macOS:

   source venv/bin/activate

   pip install -r requirements.txt

2. Настройка доступов:

   • Скопируйте .env.example в .env и добавьте ваш GEMINI_API_KEY.
   • Для работы модулей Workspace поместите credentials.json в корень проекта.

3. Запуск:

   python main.py

---

"Evolving from reactive to autonomous."