Перейти к содержанию

Cognitive Core

Биоинспирированная когнитивная система на Python

Tests Coverage Python License

Что это такое

Cognitive Core — это когнитивная система с нуля, вдохновлённая архитектурой человеческого мозга. Не LLM-обёртка, а полноценный когнитивный цикл: восприятие → кодирование → память → рассуждение → действие.

Запрос → Perception → Encoding → Memory → Cognition → Output

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

git clone https://github.com/whatisdantes/cognitive-core.git
cd cognitive-core
python -m venv .venv && .venv\Scripts\activate
pip install -e ".[dev]"
cognitive-core "что такое нейрон?"

Для полного набора опциональных зависимостей:

pip install -e ".[all]"

Для поддержки SQLCipher отдельно:

pip install -e ".[encrypted]"

Автономный режим (5 тиков планировщика):

cognitive-core --autonomous --ticks 5

С JSONL-логированием:

cognitive-core --log-dir brain/data/logs --log-level DEBUG "что такое нейрон?"

Архитектура — 12 слоёв

Слой Модуль Статус
00 Autonomous Loop brain/core/scheduler.py ✅
01 Perception brain/perception/ ✅
02 Modality Encoders brain/encoders/ ✅
03 Cross-Modal Fusion brain/fusion/ ✅ Этап K (61 тест)
04 Memory System brain/memory/ ✅
05 Cognitive Core brain/cognition/ ✅ 20-step pipeline
06 Learning Loop brain/learning/ ✅ (OnlineLearner + KnowledgeGapDetector + ReplayEngine + интеграция)
07 Output Layer brain/output/ ✅
08 Attention/Resource brain/core/, brain/cognition/ ✅ Этап H
09 Logging/Observability brain/logging/ ✅
10 Safety Boundaries brain/safety/ ✅ Этап L (107 тестов)
11 Midbrain/Reward brain/motivation/ ✅ Этап M (84 теста)
— LLM Bridge brain/bridges/ ✅ Этап N

Ключевые возможности

  • 5 видов памяти: рабочая, семантическая, эпизодическая, процедурная, источников
  • Гибридный retrieval: BM25 + векторный поиск (cosine similarity)
  • 20-шаговый CognitivePipeline: каждый шаг тестируется изолированно (salience, budget, LLM enhance, safety input/policy/audit)
  • Safety & Boundaries: BoundaryGuard (PII redaction), SafetyPolicyLayer (SF-1/2/3), AuditLogger (JSONL)
  • Reward & Motivation: RewardEngine (5 типов), MotivationEngine (EMA + decay), CuriosityEngine
  • Cross-Modal Fusion: SharedSpaceProjector, EntityLinker, ConfidenceCalibrator, CrossModalContradictionDetector
  • Thread-safe: threading.RLock во всех модулях памяти
  • SQLite WAL: персистентность с WAL mode, опциональное шифрование через extra encrypted
  • EventBus: синхронный + ThreadPool dispatch
  • Планировщик: автономный цикл с приоритетами задач
  • CLI: cognitive-core "запрос" / cognitive-core --autonomous --ticks N / cognitive-core --log-dir DIR

Документация

  • Архитектура (BRAIN.md) — полная спецификация 12 слоёв
  • ADR — Architecture Decision Records (7 решений)
  • API Reference — автогенерированная документация модулей
  • Разработка — установка extras, проверка и инструменты разработки
  • CONTRIBUTING — руководство для контрибьюторов

Метрики

Параметр Значение
Тестовый набор 2198 collected в текущем дереве
Coverage gate 70% в CI
Ruff 0 errors
Mypy 0 errors
Python 3.11 / 3.12 / 3.13
Платформа CPU-only