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