mixseek-core 0.1.0a8

Pydantic AI-based multi-agent framework with hierarchical task delegation, round-based evaluation, and workspace CLI

English | 日本語

A multi-agent orchestration framework for LLM-powered workflows. MixSeek enables hierarchical task delegation with Leader and Member agents, round-based evaluation, and parallel team execution.

Features

• Multi-agent orchestration with Leader/Member hierarchy
• Support for multiple LLM providers (Google, OpenAI, Anthropic, xAI)
• Round-based evaluation with customizable judgment criteria
• Parallel team execution with leaderboard ranking
• Streamlit-based web UI for execution monitoring
• CLI tools for workspace management and agent execution

Installation

As a CLI Tool (Recommended)

Install globally as a command-line tool using uv:

# Install as a CLI tool (requires uv)
uv tool install mixseek-core

# Or install from source
git clone https://github.com/mixseek/mixseek-core.git
cd mixseek-core
uv tool install .

After installation, mixseek commands will be available globally:

mixseek --version

As a Python Package

Install as a library for programmatic use:

# Using pip
pip install mixseek-core

# Using uv
uv pip install mixseek-core

# Add to project dependencies (uv)
uv add mixseek-core

For development setup, see Development Guide.

Quick Start

Set Environment Variables

Choose one LLM provider and set the corresponding API key:

# Workspace directory (required)
export MIXSEEK_WORKSPACE=$HOME/mixseek-workspace

# Google Gemini (default in sample configs)
export GOOGLE_API_KEY=your-api-key

# OpenAI
export OPENAI_API_KEY=your-api-key

# Anthropic
export ANTHROPIC_API_KEY=your-api-key

# xAI (Grok)
export GROK_API_KEY=your-api-key

Initialize Workspace

mixseek init

This creates sample configuration files in your workspace:

• configs/search_news.toml - Simple orchestrator
• configs/search_news_multi_perspective.toml - Multi-team orchestrator
• configs/agents/ - Team configurations

Run Orchestration

# Execute with orchestrator config
mixseek exec "Search for the latest AI news" \
  --config $MIXSEEK_WORKSPACE/configs/search_news.toml

# Run single team
mixseek team "Analyze this topic" \
  --config $MIXSEEK_WORKSPACE/configs/agents/team_general_researcher.toml

# Launch web UI
mixseek ui

Supported LLM Providers

Provider	Model Format	Environment Variable
Google Gemini	google-gla:gemini-2.5-flash	GOOGLE_API_KEY
Google Vertex AI	google-vertex:gemini-2.5-flash	GOOGLE_APPLICATION_CREDENTIALS
OpenAI	openai:gpt-4o	OPENAI_API_KEY
Anthropic	anthropic:claude-sonnet-4-5-20250929	ANTHROPIC_API_KEY
xAI	xai:grok-3	GROK_API_KEY

Documentation

Full documentation: https://mixseek.github.io/mixseek-core/

• Getting Started (Basic) - 5-minute quick start guide
• Getting Started (Advanced) - Multi-perspective search and customization
• Quick Start Guide - Detailed setup instructions
• Member Agents Guide - Agent types and configuration
• Team Guide - Team execution and delegation
• Orchestrator Guide - Multi-team parallel execution
• Configuration Reference - All configuration options
• Docker Setup - Container-based development

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting pull requests.

License

Apache License 2.0 - see LICENSE for details.