pixie-sdk 0.2.16.dev1

Interactive debugging tool for AI applications

Pixie

Web UI for AI agents manual testing.

This is the equivalent of LangSmith Studio/Google ADK Web, but for AI agents built in all kinds of ways without the framework constraint. Easy to setup, support multi-turn interactions, Human-in-the-loop, live tracing, and more.

Why?

Manually testing AI applications is time-consuming and cumbersome. Especially for early stage development, it doesn’t make sense to build e2e product just to test, or setup automated tests/evals. So the process ends up being a lot of inputting awkwardly into the command line, and looking through walls of logs in different places.

Demo

Demo Video

Features

• Interactive Testing: Support for two way interaction with your application, plus the ability to pause/resume/stop.
• Real-time Observability: Application traces are streamed in real-time while you debug.
• Structured Input/Output: Native support for structured input/output using Pydantic models.
• Data Privacy: Communications are only between your browser and your server, your data stays private.
• Framework Support: Out-of-the-box support for popular AI development frameworks like Pydantic AI, OpenAI Agents SDK, LangChain, LangGraph, and more.

Get Started

1. Setup

In your project folder, install pixie-sdk package:

pip install pixie-sdk

Create .env file in your project folder and add LLM API key(s):

# .env
OPENAI_API_KEY=...

Add AI Development framework depdendencies as needed:

pip install pydantic-ai-slim[openai]

Start the local server for debugging by running:

pixie

2. Connect Your Application

Add @pixie.app decorator to your main application function:

# my_chatbot.py
from pydantic_ai import Agent

import pixie

# You can implement your application using any major AI development framework
agent = Agent(
    name="Simple chatbot",
    instructions="You are a helpful assistant.",
    model="gpt-4o-mini",
)


@pixie.app
async def my_chatbot():
    """Chatbot application example."""
    yield "How can I help you today?"
    messages = []
    while True:
        user_msg = yield pixie.InputRequired(str)
        response = await agent.run(user_msg, message_history=messages)
        messages = response.all_messages()
        yield response.output

You should see in the log of pixie server that your app is registered.

3. Debug with web UI

Visit the web UI gopixie.ai to start debugging.

Important Links

• Documentation - Complete documentation with tutorials and API reference
• Examples - Real-world examples and sample applications
• Demo - Live Demo with the examples server setup
• Discord - Join our community for support and discussions

Acknowledgments

This project is built on top of many awesome open-source projects:

• Langfuse for instrumentation
• Pydantic for structured data validation
• FastAPI for web API
• Strawberry for graphql
• Uvicorn for web server
• Janus for sync-async queue
• docstring-parser for docstring parsing