soorma-core 0.7.4

The Open Source Foundation for AI Agents. Powered by the DisCo (Distributed Cognition) architecture.

Soorma Core SDK

The Open Source Foundation for AI Agents.

Soorma is an agentic infrastructure platform based on the DisCo (Distributed Cognition) architecture. It provides a standardized Control Plane (Registry, Event Bus, Memory Service) for building production-grade multi-agent systems.

🚧 Status: Day 0 (Pre-Alpha)

Current Version: 0.7.2

We're in active pre-launch refactoring to solidify architecture and APIs before v1.0. The SDK and infrastructure are functional for building multi-agent systems.

Learn more: soorma.ai

Installation

During Pre-Launch: We recommend installing from local source to stay synchronized with breaking changes:

# Clone the repository
git clone https://github.com/soorma-ai/soorma-core.git
cd soorma-core

# Install from source
pip install -e sdk/python

After v1.0 Release: Standard PyPI installation will be recommended: pip install soorma-core

Requirements: Python 3.11+

Quick Start

Note: Infrastructure runs locally via Docker. Clone the repo to get started.

# 1. Clone the repository
git clone https://github.com/soorma-ai/soorma-core.git
cd soorma-core

# 2. Start local infrastructure
soorma dev --build

# 3. Run the Hello World example
cd examples/01-hello-world
python worker.py

# 4. In another terminal, send a request
python client.py Alice

Next steps: See the Examples Guide for a complete learning path.

Core Concepts

Soorma provides three agent types for building distributed AI systems:

• Worker - Executes domain-specific cognitive tasks
• Tool - Provides atomic, stateless operations
• Planner - Orchestrates multi-agent workflows

Platform Services:

• context.registry - Service discovery
• context.memory - Distributed state (Semantic, Episodic, Working memory)
• context.bus - Event choreography
• context.tracker - Observability

Learn more: See the comprehensive documentation for architecture details, patterns, and API references.

CLI Reference

Command	Description
soorma init <name>	Create a new agent project
soorma dev	Start local infrastructure
soorma dev --build	Build and start (first time)
soorma dev --status	Show infrastructure status
soorma dev --logs	View infrastructure logs
soorma dev --stop	Stop infrastructure
soorma dev --stop --clean	Stop and remove all data
soorma version	Show SDK version

The soorma dev command runs infrastructure (Registry, NATS, Event Service, Memory Service) in Docker while your agent code runs natively on the host for fast iteration and debugging.

Documentation & Resources

📚 Complete Documentation: github.com/soorma-ai/soorma-core

Key Guides:

• Examples Guide - Progressive learning path from hello-world to advanced patterns
• Developer Guide - Development workflows and testing
• Design Patterns - Autonomous Choreography and architectural patterns
• Event Patterns - Event-driven communication
• Memory Patterns - CoALA framework memory types
• Topics Guide - Complete list of event topics

🎓 Learning Path:

1. 01-hello-world - Basic Worker pattern
2. 02-events-simple - Event pub/sub
3. 03-events-structured - LLM-based event selection
4. 04-memory-working - Workflow state
5. 05-memory-semantic - RAG patterns
6. 06-memory-episodic - Multi-agent chatbot

Contributing & Support

• Repository: github.com/soorma-ai/soorma-core
• Issues: Report bugs or request features
• Discussions: Ask questions
• Changelog: Release notes

License

MIT License - see LICENSE for details.