OpenSIN-AI Code — Python Agent Development Platform

OpenSIN-AI Code ist die Python-basierte Agent Development Platform der OpenSIN-AI Organisation. Metadata-driven Architektur für schnellen Prototyping und Porting.

Teil des OpenSIN-AI Ökosystems: 175 Repos | 17 Teams | 92 Worker | 7 MCP Server

🚀 Quick Start

# Install the platform
pip install opensin-ai-code

# Create your first agent
opensin-ai agent create researcher --model gpt-4

# Test your agent
opensin-ai agent test researcher --prompt "What is AI?"

# Create a team
opensin-ai team create research-team --strategy sequential

# Execute a team task
opensin-ai team exec research-team --task "Research AI trends"

🔧 Installation

From PyPI

pip install opensin-ai-code

From Source

git clone https://github.com/OpenSIN-AI/opensin-ai-code.git
cd opensin-ai-code
pip install -e .

Development Installation

git clone https://github.com/OpenSIN-AI/opensin-ai-code.git
cd opensin-ai-code
pip install -e ".[dev]"

📦 Packages

Package	Description	Status
opensin-ai-core	Core engine with QueryEngine, Hook System, Tool System, Permission System, Subagent System, MCP Client, Sandbox, Memory System	✅ Stable
opensin-ai-cli	Command-line interface for managing agents and teams	✅ Stable
opensin-ai-sdk	Python SDK for programmatic access (integrated)	✅ Stable

🧠 Core Features

QueryEngine

Async generator pattern with ReAct loop, token budget tracking, and automatic context compaction.

Hook System

20+ hook events with 5 execution modes (shell, HTTP, function, agent, prompt) for powerful automation.

Tool System

Rich tool interface with 8 built-in tools, deferred loading, and permission-aware filtering.

Permission System

Multi-source permission rules with auto-mode classifier and bypass-immune safety checks.

Subagent System

Fork pattern with cache-identical prefixes, worktree isolation, and background-to-foreground transitions.

MCP Client

Multi-transport support (stdio, SSE, HTTP, WS, in-process) with OAuth authentication.

Sandbox

Secure code execution with filesystem/network rules and git escape prevention.

Memory System

File-based memory with index and topic files, SIN.md auto-discovery, and session memory extraction.

🔗 OpenSIN-AI Ökosystem

OpenSIN-AI Code ist Teil des umfassendsten AI Agent Systems der Welt:

Komponente	Repo	Zweck
OpenSIN Core	OpenSIN-AI/OpenSIN	Free Core Engine (Python, 310+ Pakete)
OpenSIN Backend	OpenSIN-AI/OpenSIN-backend	A2A Fleet Control Plane (SIN Solver)
OpenSIN-Code	OpenSIN-AI/OpenSIN-Code	Autonomes CLI + SDK
opensin-ai-cli	OpenSIN-AI/opensin-ai-cli	AI Coding Assistant in Rust
opensin-ai-platform	OpenSIN-AI/opensin-ai-platform	Plugin Ecosystem & GitHub Automation
17 Teams	OpenSIN-overview	92 Worker Agents
7 MCP Server	OpenSIN-overview	Chrome Extension, Computer Use, Memory, Auth

🧭 OpenSIN-AI Agent Roadmap

• Feature spec: OpenSIN-overview/docs/opensin-ai-agent-feature-spec.md
• Comparison guide: OpenSIN-documentation/docs/guide/opensin-ai-agent-features.md
• This repo is the Python agent development surface aligned with the OpenSIN-AI Agent roadmap.

📚 Documentation

Full documentation is available at docs.opensin.ai, with comprehensive coverage of:

• Getting Started
• API Reference
• Tutorials
• Integrations
• Architecture
• Best Practices
• SIN Features

🐳 Local Development

# Clone the repository
git clone https://github.com/OpenSIN-AI/opensin-ai-code.git
cd opensin-ai-code

# Setup development environment
./scripts/setup.sh

# Run tests
./scripts/test.sh

# Start development server (for API mode)
opensin-ai server start

🧪 Testing

# Run all tests
./scripts/test.sh

# Run specific test suites
python -m pytest src/core/ -v
python -m pytest src/cli/ -v
python -m pytest tests/integration/ -v

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📊 Project Stats

• 2,138+ lines of Python code
• 66 Python files
• 26 subsystem packages
• 1 core platform
• Complete metadata-driven architecture

🌐 Community

• Documentation: https://docs.opensin.ai
• GitHub: https://github.com/OpenSIN-AI/opensin-ai-code
• Discord: https://discord.gg/opensin-ai-code
• Issues: https://github.com/OpenSIN-AI/opensin-ai-code/issues

📄 License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details.

---

Built with ❤️ by the OpenSIN-AI Team