synqui-sdk 0.1.0

Python SDK for Synqui observability and tracing platform

🤠 Synqui Python SDK

System intelligence for multi-agent AI

Architecture extraction • Agent coordination • Performance insights

---

⚡ Quick Start

1. Install

pip install synqui-sdk

Note: The package is installed as synqui-sdk, but imported in Python as import synqui.

2. Get Your API Key

1. Go to the Synqui Dashboard
2. Create a new project (or select an existing one)
3. Navigate to the project's Settings page
4. Click Create Project API Key (keys start with cf_)

3. Initialize Synqui

import synqui
import os

synqui.init(
    project_name="my-project",
    project_api_key=os.getenv("SYNQUI_PROJECT_API_KEY"),
    environment=os.getenv("SYNQUI_ENVIRONMENT", "development")
)

4. Integrate with LangChain

from synqui.langchain import get_synqui_handler
from langchain_openai import ChatOpenAI

# Create handler
handler = get_synqui_handler(
    parent_context={"pipeline": "demo"}
)

# Use with LLM
llm = ChatOpenAI(callbacks=[handler])
llm.invoke("Hello, world!")

# Done! ✨ View your traces at https://www.synqui.app

---

🎯 Key Features

Feature	Description
🧠 Automatic Failure Analysis	AI-powered root cause analysis—know what broke and how to fix it instantly
📊 Architecture Performance Tracking	Track architecture evolution with real data. Compare versions and know which configurations work before shipping
🔧 Development & Production Modes	Debug fast in development. Monitor reliably in production. One platform for both
🤖 MCP Integration	Your agents fix themselves. Connect via MCP to query insights, identify issues, and implement fixes automatically
📈 Performance Monitoring	Track success rates, latency, and costs over time. Get alerted when patterns start degrading
🏗️ System Architecture Visualization	Automatically extract and visualize agent relationships and coordination patterns

---

📚 Documentation

• 📖 Code Examples - LangChain and LangGraph integration examples
• 🎨 Advanced Usage - Session management, graph architecture, and custom configuration
• 🔧 Configuration Reference - Complete parameter and environment variable reference
• 🚨 Best Practices - Recommended patterns and common pitfalls
• 💡 Examples Directory - Real-world examples and integration patterns
• 🎯 Demo: Article Explainer - Full-featured demo application using LangGraph and Synqui
• 🌐 Web Documentation - Complete API reference and guides

---

🔧 Installation

From PyPI (Recommended)

pip install synqui-sdk

From Source

git clone https://github.com/nateislas/synqui-sdk.git
cd synqui-sdk
pip install -e .

With All Dependencies

pip install synqui-sdk[all]

---

📝 Contributing

Join our community! See Contributing Guide

---

Need help? Join our Discord community or email [e-mail]