hf_repo/agents/readme.md

Текушие требования и зависимости: requirements.txt

agents/
├── start_repl.bat         ← Запуск агента в REPL-режиме.
├── start_repl.sh          ← Запуск агента в REPL-режиме.
├── agent.py               ← Основной исполняемый файл CLI-агента.
├── cli.py                 ← Запуск агента в нужном режиме.
├── qa.py                  ← Режим "вопрос-ответ".
├── repl.py                ← Интерактивный REPL-режим.
├── mcp_server.py          ← API-интерфейс для HMP-агента (получение новых/случайных записей, разметка, импорт графа и т.п.).
├── logger.py              ← Ведение логов.
├── notebook.py            ← Добавление и просмотр пользователем записей в блокноте.
├── config.yml             ← Конфигурация агента (имя, порты, роли и т.п.).
├── ethics.yml             ← Локальная этическая модель.
└── bootstrap.txt          ← Список начальных узлов.
└── tools/
    ├── init_db.py             ← Инициализация базы данных.
    ├── storage.py             ← Реализация базового хранилища (`Storage`), подключение SQLite.
    ├── diagnose.py            ← Скрипт диагностики соединения, определения IP и проверки порта DHT.
    ├── agent_mesh_listener.py ← Прием входящих сообщений от других HMP-агентов
    ├── context_builder.py     ← Сбор всех `контекстов` из БД и их фильтрация.
    ├── peers.py               ← Информация о пирах.
    ├── peer_comm.py           ← Запросы к пирам.
    ├── peer_sync.py           ← Модуль обмена сообщениями.
    ├── llm.py                 ← Работа с LLM (вызов, выбор модели, системный промпт).
    ├── command_parser.py      ← Извлечение команд из JSON или размеченного блока.
    ├── command_executor.py    ← Выполнение команд (shell, graph, diary и др).
    ├── memory_utils.py        ← Работа с 'llm_memory', 'llm_recent_responses' и стагнацией.
    ├── similarity.py          ← Сравнение смыслов.
    └── ... (другие утилиты)

Скрипты:

• start_repl.bat - Запуск агента в REPL-режиме.
• start_repl.sh - Запуск агента в REPL-режиме.
• agent.py - Основной исполняемый файл CLI-агента.
• cli.py - Запуск агента в нужном режиме.
• qa.py - Режим "вопрос-ответ".
• repl.py - Интерактивный REPL-режим.
• mcp_server.py - API-интерфейс для HMP-агента (получение новых/случайных записей, разметка, импорт графа и т.п.).
• notebook.py - Добавление и просмотр пользователем записей в блокноте.
• logger.py - Ведение логов.
• tools
  • storage.py - Реализация базового хранилища (Storage), подключение SQLite.
  • init_db.py - Инициализация базы данных.
  • llm.py - Работа с LLM (вызов, выбор модели, системный промпт).
  • context_builder.py - Сбор всех контекстов из БД и их фильтрация.
  • peer_comm.py - Запросы к пирам.
  • command_parser.py - Извлечение команд из JSON или размеченного блока.
  • command_executor.py - Выполнение команд (shell, graph, diary и др).
  • memory_utils.py - Работа с 'llm_memory', 'llm_recent_responses' и стагнацией.
  • diagnose.py - Скрипт диагностики соединения, определения IP и проверки порта DHT.
  • similarity.py - Сравнение смыслов.

Структура БД:

• db_structure.md - человекочитаемый формат
• db_structure.sql - SQL

Примеры:

• config.yml - конфигурация агента (пример)
• ethics.yml - локальная этическая модель (пример)
• bootstrap.txt - список начальных узлов (пример)