High-performance, plugin-first orchestration framework built on FastAPI.

XCore is designed to load, isolate, and manage modular extensions (plugins) in a secure, sandboxed environment. It provides a robust foundation for building scalable applications where features can be dynamically added, removed, or updated without affecting the core system.

• 🔌 Plugin-First Architecture: Everything is a plugin. Keep your core lean and your features modular.
• 🛡️ Advanced Sandboxing: AST-based scanning and resource restriction to run untrusted code safely.
• 🚀 Built on FastAPI: Leverage the speed and ecosystem of one of the fastest Python frameworks.
• 📦 Service Container: Seamless management of Databases (SQLAlchemy), Cache (Redis), and Schedulers.
• 🛠️ Dev-Friendly CLI: Hot-reload plugins, sign manifests, and verify system health with one command.
• 📊 Production Ready: Structured logging, integrated metrics, and comprehensive test coverage.

Integrating XCore into your FastAPI application is straightforward:

from fastapi import FastAPI
from xcore import Xcore
from contextlib import asynccontextmanager

# 1. Initialize the Kernel
xcore = Xcore(config_path="xcore.yaml")

@asynccontextmanager
async def lifespan(app: FastAPI):
    # 2. Boot XCore (loads plugins and services)
    await xcore.boot(app)
    yield
    # 3. Graceful shutdown
    await xcore.shutdown()

app = FastAPI(lifespan=lifespan)

@app.get("/compute")
async def compute(value: int):
    # 4. Call a plugin method dynamically
    result = await xcore.plugins.call("math_plugin", "calculate", {"x": value})
    return {"result": result}

# Clone the repository
git clone https://github.com/traoreera/xcore.git
cd xcore

# Install using Poetry
make install

Start the development server with auto-reload enabled:

make dev

XCore follows a "minimal core" philosophy. Most business logic resides in plugins, which are managed by the Plugin Supervisor.

flowchart TB
    subgraph Core["XCore Kernel"]
        X[Orchestrator] --> PS[Plugin Supervisor]
        X --> EB[Event Bus]
        X --> SC[Service Container]
    end

    PS --> Trusted[Trusted Plugins]
    PS --> Sandbox[Sandboxed Plugins]

    SC --> DB[(Database)]
    SC --> RD[(Redis)]
    SC --> SCH[Scheduler]

The xcore CLI is your control center for managing the framework.

We maintain high standards for code quality and security:

make test              # Run the full test suite
make lint-fix          # Auto-format and fix linting issues
make security-check    # Run Bandit security audit
make benchmark         # Run performance benchmarks

This project is licensed under the MIT License. See the LICENSE file for details.

Built with ❤️ by the XCore Team