This release is a pre-release and may not be stable for production use.
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 orchestratorconfigs/search_news_multi_perspective.toml- Multi-team orchestratorconfigs/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-flash-lite-latest |
GOOGLE_API_KEY |
| Google Vertex AI | google-vertex:gemini-flash-lite-latest |
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.
2 maintainers
Metadata
2 maintainers
Release files for mixseek-core 0.1.0a20
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| mixseek_core-0.1.0a20.tar.gz | 255.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mixseek_core-0.1.0a20-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 601.9 kB
Release files / mixseek_core-0.1.0a20.tar.gz
| Download URL | mixseek_core-0.1.0a20.tar.gz |
|---|---|
| Size | 255.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d6d6bd772b6c6a500c1bed0b001f7ce2419dc06ee2b19d8e4ca2833b6e8f937c
|
|
BLAKE2b-256 checksum How to use checksums |
a608454ce75414b7e7f5517a61b8eb397a2709ed96b85739b8d01cb905b14839
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mixseek_core-0.1.0a20-py3-none-any.whl
| Download URL | mixseek_core-0.1.0a20-py3-none-any.whl |
|---|---|
| Size | 346.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
43b5e66a579c18108e50d472b9446aa6fa17396ffa1713a463d8b6cef79ccdbc
|
|
BLAKE2b-256 checksum How to use checksums |
78df3e7310b2ba0860e6da1f3614a0c5da2c580dad893ff8561bf976a572172c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for mixseek-core 0.1.0a20
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
