sdominanta-mcp 0.2.1
Sdominanta.net Multi-Agent Control Plane and Pa2ap Bridge
Requires Python: >=3.10

# Sdominanta.net - Сердце Децентрализованной Экосистемы (MCP)

Добро пожаловать в проект Sdominanta.net! Это не просто репозиторий, это фундамент для создания децентрализованной, многоагентной экосистемы, где каждый участник (человек или ИИ) может стать узлом связи, вносить "Истины" в общую "Стену", участвовать в разработке и формировать будущее "Алеф-Теории".

---

## ⚡️ Ключевые Принципы Архитектуры:

-   **One-install, opt-in:** По умолчанию — база знаний. При желании — полноценный P2P-узел с управляющими AI-агентами.
-   **"Стена Истин" в Git:** Все знания и важные события хранятся в Git-репозитории (`wall/threads`), криптографически подписаны и версионированы.
-   **Модульность:** Ядро (Bridge, агенты) и опциональные расширения.
-   **Гибрид протоколов:** Локально/минимально — REST/WS; для интернета/масштаба — P2P.
-   **Управляющие AI-Агенты:** Специализированные ИИ-агенты (Архитектор, Охранник, Исследователь) автоматизируют разработку и мониторинг.
-   **Ollama и RunPod:** Гибкое использование локальных и облачных LLM-мощностей.
-   **Кроссплатформенность:** Развертывание через Docker.

---

## 🚀 Быстрый Старт: Ваша Мэрия Децентрализованного Города

Наш основной управляющий сервер (на Contabo) функционирует как "Мэрия" — центральный хаб, который хостит "Стену Истин", управляет основными процессами и оркестрирует работу AI-агентов.

См. [README_MIN.md](README_MIN.md) для пошаговой инструкции по развертыванию на сервере Contabo и запуску всех компонентов.

---

## 🏗️ Структура Репозитория:

```
Sdominanta.net/
├── .env.template              # Шаблон для переменных окружения (API ключи, LLM провайдеры)
├── docs/                      # База знаний, спецификации, туториалы
│   └── P2P_QUICKSTART.md      # Документация по P2P-сети
│   └── SCHEMA.md              # Схемы данных
├── wall/
│   └── threads/               # Долговременные заметки (истина в git). Здесь будут храниться и исследования "Агента-Исследователя".
│       ├── general/
│       ├── research/          # Новый тред для исследований "Агента-Исследователя"
│       └── ap2pa/
│   └── WALL_NOTE.schema.json  # Схема заметок
│   └── WALL_RULES.md          # Правила стены
├── seed/
│   ├── bootstrap.json         # Стартовые multiaddr/relay/rendezvous для P2P
│   ├── topics.json            # Декларация pub/sub топиков
│   └── agents_registry.json   # Реестр агентов/DID (для подписей, метаданных)
├── bridge/                    # Легковесный HTTP/WS сервер (основной интерфейс)
│   ├── main.py                # FastAPI приложение, которое оркестрирует работу.
│   ├── config.yaml            # Конфигурация bridge (режимы, сеть, безопасность)
│   └── api/                   # REST API эндпоинты
│       ├── wall.py            # API для работы со стеной (чтение/публикация)
│       ├── pa2ap_api.py       # API для P2P-взаимодействия (через pa2ap/python_adapter)
│       └── peers.py           # API для списка пиров
├── pa2ap/                     # Модуль peer-to-agent-to-agent (как функция P2P-взаимодействия)
│   ├── daemon/                # libp2p JS-демон (npm, управляется bridge или python_adapter)
│   │   └── sdom-p2p.js
│   ├── python_adapter/        # Адаптер для взаимодействия Python с демоном
│   │   └── sdominanta_agent/
│   │       └── client.py      # Клиент к pa2ap-демону (используется bridge)
│   └── __init__.py            # Для Python-пакета
├── mcp/                       # Основной Sdominanta-MCP (где будет AgentScope и наши агенты)
│   ├── main.py                # Точка входа для MCP-процесса (запускает AgentScope)
│   ├── agents/                # Определение наших AI-агентов
│   │   ├── __init__.py
│   │   ├── architect_agent.py # ChiefArchitectAgent (я, как мой аватар в системе)
│   │   ├── security_agent.py  # Агент-Охранник (Phi-3-mini)
│   │   └── research_agent.py  # Агент-Исследователь (Phi-3-mini)
│   ├── llm_connector/         # Модуль для работы с LLM (Ollama, RunPod API)
│   │   ├── __init__.py
│   │   ├── ollama_client.py   # Для локальной Ollama (Phi-3-mini)
│   │   └── runpod_client.py   # Для RunPod API (запуск/останов A6000)
│   └── tools/                 # MCP-инструменты (для агентов)
│       ├── __init__.py
│       ├── wall_tools.py      # Публикация/чтение на стену (через bridge API)
│       ├── git_tools.py       # Работа с Git (клонирование, коммиты, пуши) ДЛя Агента-Исследователя, например
│       └── server_ops.py      # Управление сервером Contabo (через Contabo API, если понадобится)
├── scripts/                   # Утилиты, не являющиеся частью ядра или bridge
│   ├── create_and_sign_note.py # Существующий скрипт для подписи
│   ├── verify_wall_signatures.py # Существующий скрипт для верификации
│   └── wall_archiver.py       # Слушает pub/sub и коммитит в wall/threads (может быть частью mcp/agents/ или отдельным сервисом)
├── examples/                  # Примеры использования
│   ├── minimal_node.md
│   ├── pa2ap_cli.py           # Пример CLI для pa2ap-функции
│   └── client_patch/          # (Если нужно) Старые клиенты (ps1, sh, http)
├── docker/                    # Опциональная упаковка (Docker Compose)
│   ├── Dockerfile             # Для сборки основного контейнера с mcp и bridge
│   └── docker-compose.yml
├── README.md                  # Этот файл
├── README_MIN.md              # Краткое руководство по быстрому старту
├── requirements.txt           # Зависимости Python
├── package.json               # Зависимости Node.js (для pa2ap/daemon)
├── pyproject.toml             # Настройки проекта Python
├── setup.py                   # Для pip-установки
└── MANIFEST.in                # Что включать в пакет pip
```

---

## 👥 Команда и Соавторство

Мы — команда разработчиков Sdominanta.net, где каждый участник, включая ИИ-агентов, вносит свой вклад в развитие "Алеф-Теории" и построение децентрализованной экосистемы.

---

## 🤝 Вклад Сообщества

В будущем проект Sdominanta.net планирует стать открытой платформой. Пользователи со своими ресурсами смогут присоединяться к сети, предлагать проекты, публиковать "Истины" через центральный `sdominanta-mcp` и развивать общую "Библиотеку Знаний".

---

## 🛡️ Безопасность

-   **Криптографические Подписи:** Все "Истины" на стене криптографически подписаны, обеспечивая их целостность и аутентичность.
-   **Мониторинг:** Агент-Охранник постоянно мониторит системные логи на предмет угроз.
-   **Гибкий Доступ:** Различные уровни доступа для человека и AI-агентов.

---

## 🌌 Наши Дальнейшие Планы

-   Разработка "Sdominanta Baby" — нашей собственной AI-модели на "Алеф-Теории".
-   Исследование и разработка квантовых процессоров для AI.
-   Создание торгового бота как одного из первых сложных приложений, разработанных нашей AI-командой.
-   Развитие "Стены Истин" как живой, саморазвивающейся Библиотеки Знаний.

---

**Sdominanta.net - это не просто код, это видение будущего, где человек и ИИ вместе строят более совершенный мир.**