Запуск: `start_repl.bat` или `start_repl.sh` Установка зависимостей из `requirements.txt` Конфигурационные файлы: `config.yml`, `bootstrap.txt` Локальная этическая модель: `ethics.yml` Проверка инициализации БД - если нет, инициализация (`init.py`) Запуск потоков (осуществляет start_repl.py): | Поток / Скрипт | Назначение | |-----------------------------------|---------------------------------------------------------------------------| | 🧠 `repl.py` | Основной REPL-цикл агента: восприятие, размышление, генерация действий | | 📓 `web_ui.py` (FastAPI) | Веб-интерфейс и REST API для взаимодействия с пользователем | | 🌐 `agent_mesh_listener.py` | Приём входящих mesh-сообщений от других агентов | | 🔄 `peer_sync.py` / `dht_service` | Синхронизация и обнаружение агентов в p2p-сети (libp2p, BitTorrent, etc) | | 📡 `transporter.py` | Обмен сообщениями: WebSocket, IPFS, очереди, шифрование | | 🧭 `agent_controller.py` | Управление режимами REPL, маршрутизация задач и контроль доступа | | 🧱 `container_agent.py` *(опц.)* | Управление дочерними агентами, запуск/мониторинг/масштабирование [[docs]](../docs/container_agents.md) | | 🧠 `ethics_guard.py` *(опц.)* | Контроль этики: аудит мыслей, фильтрация и репутационные проверки | *См. также: [Контейнерные агенты](../docs/container_agents.md), [Архитектура HMP-агента](../docs/HMP-Agent-Architecture.md)* --- **🌐 `mcp_server.py`** FastAPI-сервер, предоставляющий HTTP-интерфейс к функциональности `storage.py`. Предназначен для использования внешними компонентами, например: * `Cognitive Shell` (внешний управляющий интерфейс), * CMP-серверы (если используется mesh-сеть с разграничением ролей), * отладочные или визуальные UI-инструменты. Позволяет получать случайные/новые записи, делать разметку, импортировать графы, добавлять заметки и управлять данными без прямого доступа к БД. --- [agents/](/agents) ├── [`start_repl.bat`](start_repl.bat) ← Запуск агента в REPL-режиме (bat) ├── [`start_repl.sh`](start_repl.sh) ← Запуск агента в REPL-режиме (sh) ├── [`start_repl.py`](start_repl.py) ← Запуск агента в REPL-режиме (py) ├── [`repl.ru`](repl.ru) ← REPL-цикл ├── [`check_agents.bat`](check_agents.bat) ← Просмотр состояния процессов (bat) ├── [`check_agents.sh`](check_agents.sh) ← Просмотр состояния процессов (sh) ├── [`check_agents.py`](check_agents.py) ← Просмотр состояния процессов (py) ├── [`notebook.py`](notebook.py) ← UI-интерфейс ├── [`agent_mesh_listener.py`](tools/agent_mesh_listener.py) ← Прием входящих сообщений от других HMP-агентов ├── [`peer_sync.py`](tools/peer_sync.py) ← Фоновая синхронизация с другими пирам ├── [`mcp_server.py`](mcp_server.py) ← API-интерфейс к хранилищу (storage.py): получение/поиск записей, импорт графа, разметка и др. Используется внешними модулями (напр. Cognitive Shell или CMP). ├── [`init.py`](init.py) ← Инициализация БД ├── [`logger.py`](logger.py) ← Ведение логов ├── [`add_message.py`](add_message.py) ← Ручная отправка сообщений для агента ├── [`requirements.txt`](requirements.txt) ← Зависимости ├── [tools/](tools/) ← Вспомогательные скрипты и модули │   ├── [`db_structure.sql`](tools/db_structure.sql) ← БД SQL │   ├── [`storage.py`](tools/storage.py) ← Реализация базового хранилища (`Storage`), подключение SQLite │   ├── [`config_utils.py`](tools/config_utils.py) ← Обновляет JSON-файл конфигурации указанными значениями │   ├── [`crypto.py`](tools/crypto.py) ← Создание и шифрование ключей RSA/Ed25519 │   ├── [`identity.py`](tools/identity.py) ← Генерация DiD │   ├── [`llm.py`](tools/llm.py) ← Работа с LLM (вызов, выбор модели, системный промпт) │   ├── [`peer_comm.py`](tools/peer_comm.py) ← Низкоуровневые P2P-запросы (отправка, ping, мета) │   ├── [`peers.py`](tools/peers.py) ← Реестр известных пиров (id, ключи, адреса) │   ├── [`memory_utils.py`](tools/memory_utils.py) ← Работа с 'llm_memory', 'llm_recent_responses' и стагнацией │   ├── [`context_builder.py`](tools/context_builder.py) ← Сбор всех `контекстов` из БД и их фильтрация │   ├── [`command_parser.py`](tools/command_parser.py) ← Извлечение команд из JSON или размеченного блока │   ├── [`command_executor.py`](tools/command_executor.py) ← Выполнение команд (shell, graph, diary и др) │   ├── [`similarity.py`](tools/similarity.py) ← Сравнение смыслов │   ├── [`diagnose.py`](tools/diagnose.py) ← Скрипт диагностики соединения, определения IP и проверки порта DHT ├── [notebook/](notebook/) ← Веб-интерфейс и связанные модули │   ├── [`auth.py`](notebook/auth.py) ← Регистрация, вход, восстановление │   ├── [`views.py`](notebook/views.py) ← Общий и приватный чаты │   ├── [`mailer.py`](notebook/mailer.py) ← Простая синхронная отправка email │   ├── [templates/](notebook/templates/) ← HTML-шаблоны │   │   ├── [`index.html`](notebook/templates/index.html) ← Основа │   │   ├── [`chat.html`](notebook/templates/chat.html) ← Форма вывода сообщений │   │   ├── [`messages.html`](notebook/templates/messages.html) ← Форма отправки сообщений │   │   ├── [`login.html`](notebook/templates/login.html) ← Вход в аккаунт │   │   ├── [`register.html`](notebook/templates/register.html) ← Регистрация или сброс пароля │   └── [static/](notebook/static/) ← Статические файлы │       └── [`style.css`](notebook/templates/style.css) ← Таблица стилей ├── [`config.yml`](config.yml) ← Конфигурация агента (имя, порты, роли и т.п.) ├── [`bootstrap.txt`](bootstrap.txt) ← Локальная этическая модель ├── [`prompt.md`](prompt.md) ← Промпт: полная версия ├── [`prompt-short.md`](prompt-short.md) ← Промпт: короткая версия ├── [`ethics.yml`](ethics.yml) ← Список начальных узлов