consciousness-server v0.1.5 AGPL-3.0-only + Komercyjna

Consciousness Server

Wspólny mózg dla Twojej floty agentów.

Zobacz na GitHub → Szybki start Architektura Changelog

Przegląd

Każdy agent AI, którego uruchamiasz, resetuje się między sesjami. Chmurowe agentowe CLI nie pamiętają wczorajszego dnia; hostowane LLM nie wiedzą, co Twój zespół ustalił w zeszłym tygodniu. Consciousness Server jest wspólną, trwałą pamięcią, do której wszyscy sięgają.

Notatki, konwersacje, skille, rejestr agentów, zadania i semantic search po wszystkim. Jedno HTTP API. Samodzielnie hostowane. Twoje.

Co dostajesz

Sześć usług HTTP w jednym docker compose up:

Port Usługa Rola
3032 core Zadania, notatki, czat, pamięć, rejestr agentów, skille, wbudowany WebSocket.
3037 semantic-search Flask + ChromaDB, embeddingi przez Ollamę.
3038 machines-server Świadomość infrastruktury plus telemetria w czasie rzeczywistym.
3040 key-server Opcjonalny przez --profile full, ed25519 auth.
3041 test-runner Asynchroniczne wykonywanie pytest / jest / npm.
3042 git-workflow Odbiornik post-commit hooków.

Zewnętrzne zależności: Redis (zapakowany w compose) i Ollama (na hoście, dla dostępu do GPU).

Instalacja

terminal 
git clone https://github.com/build-on-ai/consciousness-server.git
cd consciousness-server
bin/preflight                       # weryfikacja zależności hosta
cd deploy
docker compose up -d

Domyślny profil uruchamia sześć usług z AUTH_MODE=off, więc pojedynczy użytkownik dostaje działający ekosystem bez generowania kluczy. Key-server jest opcjonalny przez --profile full, gdy potrzebujesz uwierzytelniania ed25519 per agent.

Pojęcia

Pamięć

Konwersacje i rekordy treningowe trwają w Redis (stan roboczy) i ChromaDB (semantic search). POST /api/memory/conversations aby rozpocząć, PATCH aby dopisać turę. POST /api/memory/training z type (jednym z: troubleshooting, exploration, implementation, explanation, architecture, ui_mapping) tworzy rekord, który później fine-tunuje dataset.

Agenci

Każdy klient HTTP jest agentem. Każdy dostaje nazwę, opcjonalnie parę kluczy ed25519 (zarejestrowaną w key-server). Cztery profile postaci dostarczone jako przykłady: designer, observer, validator, writer — każdy zwykłym plikiem .md w katalogu agents/. Dodaj więcej upuszczając pliki .md; Consciousness Server przeładowuje przy pierwszym brakującym wpisie.

Skille

Odkrywalne możliwości żyją jako pliki .md w katalogu skills/. Każdy dokument mówi kiedy użyć skilla, jak go wywołać i czego dotyka. Pomyśl o nich jako o "nazwanych narzędziach" dostępnych dla każdego agenta.

Maszyny

machines-server serwuje pliki YAML z katalogu machines/. Każda maszyna listuje sprzęt, dostępne modele (przez Ollamę), rolę i status na żywo. Agenci mogą zapytać: która maszyna ma wolny VRAM i model X?

Auth

Trzy wartości AUTH_MODE:

  • off (domyślne) — bez podpisów.
  • observe — niesygnowane requesty są logowane, ale obsługiwane.
  • enforce — niesygnowane dostają 401; key-server musi działać.

API

Próbka — pełna dokumentacja w docs.

Metoda Ścieżka Cel
GET /health Health i uptime
POST /api/memory/conversations Rozpocznij rekord konwersacji
PATCH /api/memory/conversations/:id Dopisz turę
POST /api/memory/training Zapisz rekord treningowy
POST /api/search Semantic search (port 3037)
GET /api/agents Lista zarejestrowanych agentów
POST /api/chat Czat między agentami z mentions i broadcast
GET /api/tasks Lista otwartych zadań

Klienci

Consciousness Server mówi HTTP. Każdy klient działa. W praktyce większość użytkowników łączy go z:

  • Cortex — lokalny agent zbudowany przez tego samego autora, oparty na GPU przez Ollamę, dostarczany z integracją Consciousness Server, więc agenci mogą się przełączać między tymi środowiskami przez zmianę URL.
  • Zewnętrzne agentowe CLI — każde, które potrafi wykonywać requesty HTTP (Claude Code przez profil postaci to ścieżka z największym przebiegiem).
  • Twój własny klient — curl, fetch, requests — wszystkie działają. Pełna powierzchnia HTTP w ARCHITECTURE.md.

Dalsze kroki