paracle 1.0.2

User-driven multi-agent framework for AI-native applications

Multi-Agent Framework for AI-Native Applications

Write Once, Deploy Everywhere

Quick Start | Documentation | Architecture | Innovative Features

---

Overview

Paracle is a framework for building production-ready multi-agent AI applications. Designed for scalability, security, and interoperability, Paracle enables organizations to develop sophisticated AI systems with confidence.

Core Capabilities

Agent Inheritance Implement sophisticated agent hierarchies using object-oriented principles. Inherit configurations, behaviors, and capabilities across agent families for maintainable, scalable systems. Multi-Provider Architecture Support for 14+ LLM providers ensures vendor flexibility: Commercial: OpenAI, Anthropic, Google AI, xAI, DeepSeek, Groq, Mistral AI, Cohere, Together AI, Perplexity, OpenRouter, Fireworks AI Self-Hosted: Ollama, LM Studio, vLLM, llama.cpp, LocalAI, Jan Framework Agnostic Seamless integration with leading AI frameworks: Microsoft Semantic Kernel (MSAF), LangChain, LlamaIndex. Choose the right tool for your use case. Portable Skills System Define agent capabilities once, deploy across platforms: GitHub Copilot, Cursor, Claude Code, OpenAI Codex, and custom IDEs.

API-First Architecture Production-grade RESTful API built with FastAPI. Comprehensive OpenAPI documentation, authentication, and rate limiting included. Model Context Protocol (MCP) Native support for the emerging MCP standard, enabling standardized tool discovery and interoperability across AI platforms. Agent-to-Agent Protocol (A2A) Federated agent communication protocol supporting distributed multi-agent systems and cross-organization collaboration. Enterprise Flexibility Bring Your Own (BYO) architecture: models, frameworks, tools, infrastructure. No vendor lock-in. Security & Compliance 95/100 security score (Bandit, Safety, Semgrep) ISO 27001:2022 & ISO 42001:2023 aligned SOC2 Type II compliant controls OWASP Top 10 & GDPR compliant

Quick Start

Installation

Using uv (Recommended) uv pip install paracle

Using pip pip install paracle

Configuration

API Keys Setup # Copy example and add your keys cp .env.example .env # Edit .env with your API keys 📖 API Keys Guide

✅ Step 3: Verify Installation

paracle hello

Interactive Tutorial (30 minutes hands-on training)

paracle tutorial start

Training Modules:

1. Agent creation and configuration
2. Tool integration (filesystem, HTTP, shell)
3. Skills definition and deployment
4. Project template development
5. Local testing and validation
6. Workflow orchestration

Resume anytime: paracle tutorial resume

🎯 Step 4: Initialize & Run Your First Agent

# Initialize workspace
paracle init

# List available agents
paracle agents list

# Run an agent with a task
paracle agents run coder --task "Create a hello world script"

💻 Or Use the Python API

from paracle_domain.models import AgentSpec, Agent

# Define an agent
agent_spec = AgentSpec(
    name="code-assistant",
    description="A helpful coding assistant",
    provider="openai",
    model="gpt-4",
    temperature=0.7,
    system_prompt="You are an expert Python developer."
)

agent = Agent(spec=agent_spec)
print(f"✅ Agent created: {agent.id}")

🎉 That's it! You're ready to build AI applications with Paracle!

📦 Project Structure

paracle-lite/
├── .parac/              # Project workspace (config, memory, runs)
├── packages/            # Modular packages
│   ├── paracle_core/           # Core utilities
│   ├── paracle_domain/         # Domain models
│   ├── paracle_store/          # Persistence
│   ├── paracle_events/         # Event bus
│   ├── paracle_providers/      # LLM providers
│   ├── paracle_adapters/       # Framework adapters
│   ├── paracle_orchestration/  # Workflow engine
│   ├── paracle_tools/          # Tool management
│   ├── paracle_skills/         # Skills system (multi-platform)
│   ├── paracle_mcp/            # MCP protocol client
│   ├── paracle_api/            # REST API
│   └── paracle_cli/            # CLI
├── tests/               # Test suite
├── content/             # Documentation and templates
│   ├── docs/            # User documentation
│   └── templates/       # Project templates
└── content/examples/    # Example projects

🏗️ Architecture

Paracle follows a modular monolith architecture with clear boundaries:

• Domain Layer: Pure business logic (agents, workflows, tools)
• Infrastructure Layer: Persistence, events, providers
• Application Layer: Orchestration, API, CLI
• Adapters: External integrations (MSAF, LangChain, etc.)

See Architecture Documentation for details.

More Features

Agent Inheritance System

Hierarchical Agent Architecture

# Base agent
base_agent = AgentSpec(
    name="base-coder",
    provider="openai",
    model="gpt-4",
    temperature=0.7
)

# Specialized agent (inherits from base) 🎯
python_expert = AgentSpec(
    name="python-expert",
    parent="base-coder",  # ← Inheritance magic!
    system_prompt="Expert in Python best practices",
    tools=["pytest", "pylint"]
)

🔌 Multi-Provider Support - Switch providers instantly

# OpenAI 🤖
agent1 = AgentSpec(provider="openai", model="gpt-4")

# Anthropic 🧠
agent2 = AgentSpec(provider="anthropic", model="claude-sonnet-4.5")

# Local (free!) 💻
agent3 = AgentSpec(provider="ollama", model="llama3")

14+ providers supported - Commercial + Self-hosted

Workflow Orchestration

from paracle_domain.models import Workflow, WorkflowStep

workflow = Workflow(
    name="code-review",
    steps=[
        WorkflowStep(
            id="analyze",
            agent_id="analyzer",
            prompt="Analyze this code"
        ),
        WorkflowStep(
            id="suggest",
            agent_id="advisor",
            prompt="Suggest improvements",
            dependencies=["analyze"]  # ← Sequential execution
        )
    ]
)

📖 Documentation

🎓 Getting Started ⚡ Getting Started Guide 🔑 API Keys Configuration 🔌 Providers Guide	🏗️ Architecture & Design 🎯 Architecture Overview 🔄 Synchronization Guide 🌐 API-First CLI	✨ Features 🎯 Skills System 🔧 Built-in Tools 📡 MCP Integration 🔒 Security Audit
📚 Reference 🗺️ Roadmap • 📝 Architecture Decisions • 💡 Examples

🛠️ Development

🔧 Setup Development Environment

# Clone repository
git clone https://github.com/IbIFACE-Tech/paracle-lite.git
cd paracle-lite

# Install with dev dependencies
make install-dev

# Or with uv (recommended)
uv sync --all-extras

🧪 Running Tests

# Run all tests
make test

# With coverage report
make test-cov

# Watch mode (auto-reload)
make test-watch

700+ tests - Unit, integration, and end-to-end

✨ Code Quality

# Run all linters
make lint

# Auto-format code
make format

Tools: ruff, mypy, black, isort

🗺️ Roadmap

Paracle v1.0.2 is production-ready! 🎉

Current Phase: Phase 10 - Governance & v1.0 Release (95% complete)

📋 View Full Roadmap • 🎯 Current Phase Details

Contributing

We welcome contributions from the community.

1. Fork Fork Repository

2. Branch Create Feature Branch

3. Develop Implement Changes

4. Test Validate Quality

5. Submit Pull Request

Contributing Guidelines | Code of Conduct

📄 License

Licensed under Apache License 2.0

Free and open source for personal and commercial use

---

🔗 Connect with Us

💬 Get Support

🐛 Bug Reports • ✨ Feature Requests • ❓ Questions • 💡 Ideas

All welcome on GitHub Issues and Discussions

---

Paracle Framework

Version 1.0.1 700+ Tests | 95/100 Security Score | ISO/SOC2 Compliant

Built with ❤️ by IbIFACE Team

Back to top