XYBEROS — Cognitive Operating System

A Python framework for building cognitive AI systems with a full pipeline: perceive, reason, plan, decide, act, reflect, and remember.

Quick Start

pip install xyberos

from xyberos import xyberos

ctx = xyberos.chat("Hello, world!")
print(ctx.thought.summary)

Or with Docker:

docker compose up

Features

• Cognitive pipeline — 8-stage processing loop with pluggable strategies
• Plugin system — unified Plugin contract with 12 entry-point groups, 54 auto-discovered components
• Security subsystem — authentication, authorization, RBAC, Guardian decision engine, risk scoring, audit trail, capability management, policy engine, human-in-the-loop approval, resource governance
• 6-tier memory — working, episodic, semantic, procedural, vector, knowledge graph with automatic fallback
• Multi-agent runtime — agent communication, shared memory, task delegation, collaborative voting
• Model-agnostic LLM — OpenAI, Anthropic, Ollama, OpenAI-compatible, simulated backends
• Pluggable tools & skills — web search, file I/O, calculator, shell commands, and custom extensions
• REST API — FastAPI server with OpenAPI docs
• Configuration — YAML + env vars + programmatic overrides
• Docker — one-command deployment with docker compose up
• ML evaluation — built-in classification and regression metrics

Documentation

Full documentation is available in the docs/ directory:

• Getting Started
• XYBEROS API & Assistant
• Creating Tools
• Multi-Agent Systems
• Memory System
• Security Subsystem
• Configuration
• Plugin Discovery & Providers
• API Reference

Stability

XYBEROS is currently in pre-release (0.x). The public API is stabilizing but may change between minor versions. Breaking changes are documented in CHANGELOG.md.

See VERSIONING.md for the versioning policy.

Requirements

• Python 3.12+

License

Apache 2.0 — see LICENSE.