Metadata-Version: 2.4
Name: xyberos
Version: 0.4.1
Summary: XYBEROS Cognitive Operating System
Author: Baltazar De Chavez Jr.
License: Apache-2.0
Project-URL: Homepage, https://github.com/xyberos/xyberos
Project-URL: Documentation, https://github.com/xyberos/xyberos/tree/main/docs
Project-URL: Source, https://github.com/xyberos/xyberos
Project-URL: Changelog, https://github.com/xyberos/xyberos/blob/main/CHANGELOG.md
Project-URL: Repository, https://github.com/xyberos/xyberos
Project-URL: Issues, https://github.com/xyberos/xyberos/issues
Keywords: ai,framework,microkernel,agent,automation,cognitive,runtime,operating-system
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyYAML>=6.0
Provides-Extra: dev
Requires-Dist: pytest>=8.4; extra == "dev"
Requires-Dist: pytest-asyncio>=1.1; extra == "dev"
Requires-Dist: ruff>=0.12; extra == "dev"
Requires-Dist: mypy>=1.17; extra == "dev"
Provides-Extra: web
Requires-Dist: fastapi>=0.116; extra == "web"
Requires-Dist: uvicorn>=0.35; extra == "web"
Provides-Extra: gui
Requires-Dist: PySide6>=6.9; extra == "gui"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.6; extra == "docs"
Requires-Dist: mkdocs-material>=9.6; extra == "docs"
Dynamic: license-file

# XYBEROS — Cognitive Operating System

[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/)
[![Tests](https://img.shields.io/badge/tests-1661%20passed-green)]()
[![Version](https://img.shields.io/badge/version-0.4.0--dev-orange)]()

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

## Quick Start

```bash
pip install xyberos
```

```python
from xyberos import xyberos

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

Or with Docker:

```bash
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
- **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 at [docs/](docs/index.md):

- [Getting Started](docs/getting-started.md)
- [XYBEROS API](docs/guide/assistant.md)
- [Creating Tools](docs/guide/tools.md)
- [Multi-Agent Systems](docs/guide/agents.md)
- [Memory System](docs/guide/memory.md)
- [Configuration](docs/guide/configuration.md)
- [Plugin Discovery](docs/guide/providers.md)
- [API Reference](docs/api/reference.md)

## 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](CHANGELOG.md).

See [VERSIONING.md](VERSIONING.md) for the versioning policy.

## Requirements

- Python 3.12+

## License

Apache 2.0 — see [LICENSE](LICENSE).
