oxo-call

Model-intelligent orchestration for CLI bioinformatics

Describe your task in plain language — oxo-call fetches the tool's documentation, grounds the request with a built-in skill, and asks your LLM backend to generate the exact flags you need.

→ Full documentation, tutorials, and how-to guides: traitome.github.io/oxo-call/documentation

What is oxo-call?

oxo-call is an AI-powered CLI assistant for bioinformatics. Instead of memorizing hundreds of flags across dozens of tools, you describe what you want to accomplish — oxo-call translates that into a correct, grounded command.

  Natural-language task  ──▶  Documentation + Skill  ──▶  LLM  ──▶  Exact command

• 🧠 LLM-powered — GitHub Copilot, OpenAI, Anthropic, or local Ollama
• 📚 Docs-grounded — tool --help output is cached and injected before every LLM call
• 🎯 Skill system — built-in expert knowledge for 158 bioinformatics tools
• 🔄 Workflow engine — native DAG-based pipelines with Snakemake/Nextflow export
• 🔍 Dry-run mode — preview every command before it runs
• 📜 History — every execution is logged with provenance metadata
• 📋 Job library — save named command shortcuts with scheduling, history, and LLM generation (oxo-call job)

Quick Start

1. Install (Recommended: Pre-built Binaries)

The easiest way to install oxo-call is to download pre-built binaries from GitHub Releases:

# Linux/macOS
curl -fsSL https://github.com/Traitome/oxo-call/releases/latest/download/oxo-call-linux-x86_64 -o oxo-call
chmod +x oxo-call
sudo mv oxo-call /usr/local/bin/

# Or macOS (Apple Silicon)
curl -fsSL https://github.com/Traitome/oxo-call/releases/latest/download/oxo-call-macos-aarch64 -o oxo-call
chmod +x oxo-call
sudo mv oxo-call /usr/local/bin/

# Or Windows
# Download from: https://github.com/Traitome/oxo-call/releases

See the Installation guide for all platforms and options.

Alternative: Install via Conda (Bioconda)

If you use conda, you can install oxo-call from Bioconda:

# Install bioconda if you haven't already
# conda config --add channels conda-forge
# conda config --add channels bioconda
# conda config --set channel_priority strict

conda install oxo-call -c bioconda -c conda-forge

Or with mamba (faster):

mamba install oxo-call -c bioconda -c conda-forge

Note: Bioconda support is experimental. Please report any issues at https://github.com/Traitome/oxo-call/issues.

Alternative: Install via Cargo

If you have Rust installed, you can also install via cargo:

cargo install oxo-call

2. Get a license

A signed license is required for core commands. Academic licenses are free.

# Apply at: https://github.com/Traitome/oxo-call#license
# Then place your license file or set the environment variable:
export OXO_CALL_LICENSE=/path/to/license.oxo.json

3. Configure your LLM and run

# GitHub Copilot (default)
oxo-call config set llm.api_token <your-github-token>

# Preview a command without running it
oxo-call dry-run samtools "sort input.bam by coordinate and output to sorted.bam"
# → samtools sort -o sorted.bam input.bam

# Execute a command
oxo-call run bwa "align reads.fastq to reference.fa using 8 threads"

# Run a built-in workflow pipeline
oxo-call workflow dry-run rnaseq

For OpenAI, Anthropic, Ollama, and full configuration details, see the Configuration guide.

Documentation

The full documentation is a hands-on tutorial book covering everything from first steps to advanced workflow design:

Community & Feedback

oxo-call is a user-driven project — your real-world usage and feedback directly shape what gets built next.

We are actively looking for early adopters and testers across all stages of bioinformatics work. The more you use it and report back, the better it gets for everyone.

• 🐛 Found a bug? Open a bug report
• 💡 Have a feature idea? Request a feature
• 🎯 Missing a skill for your tool? Request a skill
• 📣 Share how you use it — real-world use cases help prioritize development

We especially welcome feedback from students, researchers, and core facility staff who run oxo-call on real data. Every issue filed and every comment left makes the tool better!

License

Dual License — Academic Free / Commercial Per-Organization

Apply for an academic license or contact w_shixiang@163.com for commercial licensing.

A public test license for evaluation is available at docs/public-academic-test-license.oxo.json.

Skill files contributed to the community registry are licensed under CC-BY-4.0.