Metadata-Version: 2.4
Name: mixseek-core
Version: 0.1.0a8
Summary: Pydantic AI-based multi-agent framework with hierarchical task delegation, round-based evaluation, and workspace CLI
Keywords: multi-agent,ai-agent,pydantic-ai,llm,framework,google-genai,anthropic,openai
Author: AlpacaTech Co. Ltd.
Author-email: AlpacaTech Co. Ltd. <ask@alpaca-tech.ai>
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Requires-Dist: duckdb>=1.4.2
Requires-Dist: google-cloud-aiplatform>=1.128.0
Requires-Dist: google-genai>=1.52.0
Requires-Dist: pandas>=2.3.3
Requires-Dist: plotly>=6.5.0
Requires-Dist: pydantic>=2.12.5
Requires-Dist: pydantic-ai>=1.26.0
Requires-Dist: pydantic-settings>=2.12.0
Requires-Dist: streamlit>=1.51.0
Requires-Dist: typer>=0.20.0
Requires-Dist: google-adk>=1.19.0 ; extra == 'adk'
Requires-Dist: logfire>=4.15.1 ; extra == 'logfire'
Requires-Python: >=3.13.7
Project-URL: Homepage, https://github.com/mixseek/mixseek-core
Project-URL: Repository, https://github.com/mixseek/mixseek-core
Project-URL: Documentation, https://mixseek.github.io/mixseek-core/
Project-URL: Issues, https://github.com/mixseek/mixseek-core/issues
Provides-Extra: adk
Provides-Extra: logfire
Description-Content-Type: text/markdown

<p align="center">
  <img src="https://raw.githubusercontent.com/mixseek/mixseek-core/main/docs/assets/mixseek700x144_Navy.svg" alt="MixSeek" width="350">
</p>

<p align="center">
  <a href="https://github.com/mixseek/mixseek-core/actions/workflows/ci.yml"><img src="https://github.com/mixseek/mixseek-core/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  <a href="https://mixseek.github.io/mixseek-core/"><img src="https://img.shields.io/badge/docs-GitHub%20Pages-blue" alt="Documentation"></a>
  <a href="https://github.com/mixseek/mixseek-core/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License"></a>
  <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.13+-blue.svg" alt="Python"></a>
</p>

<p align="center">
  <a href="https://github.com/mixseek/mixseek-core/blob/main/README.md">English</a> | <a href="https://github.com/mixseek/mixseek-core/blob/main/README.ja.md">日本語</a>
</p>

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`:

```bash
# 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:

```bash
mixseek --version
```

### As a Python Package

Install as a library for programmatic use:

```bash
# 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](https://mixseek.github.io/mixseek-core/developer-guide.html).

## Quick Start

### Set Environment Variables

Choose one LLM provider and set the corresponding API key:

```bash
# 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

```bash
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

```bash
# 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)](https://mixseek.github.io/mixseek-core/getting-started.html) - 5-minute quick start guide
- [Getting Started (Advanced)](https://mixseek.github.io/mixseek-core/getting-started-advanced.html) - Multi-perspective search and customization
- [Quick Start Guide](https://mixseek.github.io/mixseek-core/quickstart.html) - Detailed setup instructions
- [Member Agents Guide](https://mixseek.github.io/mixseek-core/member-agents.html) - Agent types and configuration
- [Team Guide](https://mixseek.github.io/mixseek-core/team-guide.html) - Team execution and delegation
- [Orchestrator Guide](https://mixseek.github.io/mixseek-core/orchestrator-guide.html) - Multi-team parallel execution
- [Configuration Reference](https://mixseek.github.io/mixseek-core/configuration-reference.html) - All configuration options
- [Docker Setup](https://mixseek.github.io/mixseek-core/docker-setup.html) - Container-based development

## Contributing

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

## License

Apache License 2.0 - see [LICENSE](https://github.com/mixseek/mixseek-core/blob/main/LICENSE) for details.
