Skip to main content

Multi-Agent Bioinformatics Analysis System powered by LangGraph

Project description

Lobster AI Logo Open-source multi-agent bioinformatics engine.
Describe your analysis in natural language.

Docs Cloud PyPI

Testimonial 1 Testimonial 2 Testimonial 3


🧑‍🔬 Human Quickstart

1. Install Lobster AI (macOS/Linux):

curl -fsSL https://install.lobsterbio.com | bash

(Windows users: irm https://install.lobsterbio.com/windows | iex)

2. Configure your LLM (Anthropic, Gemini, local Ollama, etc.):

lobster init

3. Start an interactive session and run a full pipeline:

lobster chat

Then describe your analysis:

> Search PubMed for single-cell CRISPR screens in T cells from 2023–2024,
  download the most cited dataset, run QC, integrate batches with Harmony,
  cluster the cells, annotate cell types, and export a reproducible notebook.
Watch: installation & init walkthrough
Installation and Init

🤖 For AI Coding Agents

Teach your coding agent (Claude Code, Cursor, Gemini) to use and extend Lobster AI instantly:

curl -fsSL https://skills.lobsterbio.com | bash

Installs the lobster-use and lobster-dev skills so your AI knows our entire 10-package architecture.


Real-World Use Cases

See Lobster AI applied end-to-end across omics domains:

Domain Case Study
Single-Cell Transcriptomics Cell clustering, annotation & trajectory inference
CML Drug Resistance Resistance mechanism discovery from scRNA-seq
Drug Discovery Target identification & compound prioritization
Clinical Genomics Variant annotation & GWAS analysis
Mass Spec Proteomics Biomarker panel selection from DIA-NN data
Literature Mining Automated dataset discovery from PubMed
Multi-Omics ML Feature selection & survival analysis

🧠 The Architecture

Lobster isn't just a chatbot; it's a modular ecosystem of 22 specialist agents across 10 packages.

  • Your machine, your data: Patient data never leaves your hardware.
  • Tool calls, not token dreams: Agents execute real, validated Python packages (Scanpy, PyDESeq2).
  • 100% Reproducible: W3C-PROV tracking and automatic Jupyter notebook exports.
Ecosystem Topology

Core Architecture

🛠️ Build Your Own Agent

The lobster-dev skill gives your coding assistant (Claude Code, Gemini CLI, Cursor) deep knowledge of how Lobster agents are structured. Describe the biological domain you need — it scaffolds the package, wires the tools, writes the tests, and registers the agent.

1. The Request

Claude Terminal
2. The Result

Hackability Preview

❓ Deep Dives & FAQ

What omics domains are supported?

Transcriptomics

  • Single-cell RNA-seq: QC, doublet detection (Scrublet), batch integration (Harmony/scVI), clustering, cell type annotation, trajectory inference (DPT/PAGA)
  • Bulk RNA-seq: Salmon/kallisto/featureCounts import, sample QC, batch detection, normalization (DESeq2/VST/CPM), DE with PyDESeq2, GSEA, publication-ready export

Genomics

  • GWAS: VCF/PLINK import, LD pruning, kinship, association testing, result clumping
  • Clinical: variant annotation (VEP), gnomAD frequencies, ClinVar pathogenicity, variant prioritization

Proteomics

  • Mass spec: MaxQuant/DIA-NN/Spectronaut import, PTM analysis, peptide-to-protein rollup, batch correction
  • Affinity: Olink NPX/SomaScan ADAT/Luminex MFI import, LOD quality, bridge normalization
  • Downstream: GO/Reactome/KEGG enrichment, kinase enrichment (KSEA), STRING PPI, biomarker panel selection

Metabolomics

  • LC-MS, GC-MS, NMR with auto-detection
  • QC (RSD, TIC), filtering, imputation, normalization (PQN/TIC/IS)
  • PCA, PLS-DA, OPLS-DA, m/z annotation (HMDB/KEGG), lipid class analysis

Machine Learning

  • Feature selection (stability selection, LASSO, variance filter)
  • Survival analysis (Cox models, Kaplan-Meier, risk stratification)
  • Cross-validation, SHAP interpretability, multi-omics integration (MOFA)

Research & Metadata

  • Literature discovery (PubMed, PMC, GEO, PRIDE, MetaboLights)
  • Dataset download orchestration, metadata harmonization, sample filtering
Which LLMs can I use?

Lobster supports 5 LLM providers. Configure via lobster init or environment variables.

Provider Type Setup Use Case
Ollama Local ollama pull gpt-oss:20b Privacy, zero cost, offline
Anthropic Cloud API key Fastest, best quality
AWS Bedrock Cloud AWS credentials Enterprise, compliance
Google Gemini Cloud Google API key Multimodal, long context
Azure AI Cloud Endpoint + credential Enterprise Azure
Pipeline export and slash commands
lobster chat
> /pipeline export         # Export reproducible Jupyter notebook
> /pipeline list           # List exported pipelines
> /pipeline run analysis.ipynb geo_gse109564
> /data                    # Show loaded datasets
> /status                  # Session info
> /help                    # All commands
Advanced installation (Windows, pip)

Windows (PowerShell):

irm https://install.lobsterbio.com/windows | iex

uv (recommended manual install):

uv tool install 'lobster-ai[full,anthropic]'
lobster init

pip:

pip install 'lobster-ai[full]'
lobster init

Upgrade:

uv tool upgrade lobster-ai    # uv
pip install -U lobster-ai      # pip
How do I build my own agent?

Create custom agents for any domain. Agents plug in via Python entry points — discovered automatically, no core changes needed.

Install the lobster-dev skill to teach your coding agent the full architecture:

curl -fsSL https://skills.lobsterbio.com | bash

Then ask your coding agent: "Create a Lobster agent for [your domain]" — it knows the package structure, AGENT_CONFIG pattern, factory function, tool design, testing, and the 28-step checklist.


Built to accelerate multi-omics research.

Omics-OS  ·  Lobster AI  ·  Docs

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lobster_ai-1.1.3.tar.gz (1.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

lobster_ai-1.1.3-py3-none-any.whl (1.5 MB view details)

Uploaded Python 3

File details

Details for the file lobster_ai-1.1.3.tar.gz.

File metadata

  • Download URL: lobster_ai-1.1.3.tar.gz
  • Upload date:
  • Size: 1.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for lobster_ai-1.1.3.tar.gz
Algorithm Hash digest
SHA256 0d4672bddd4a32a3b5fdd63bb5b697a52cb8f5425b718e692ddee2c94ac20308
MD5 941ca3aab022fb50c55ea60502f0088f
BLAKE2b-256 5719a238ae8788991a5c2987101c23a40579859c31cc6025dec3bcce8ef8fab2

See more details on using hashes here.

Provenance

The following attestation bundles were made for lobster_ai-1.1.3.tar.gz:

Publisher: publish-packages.yml on the-omics-os/lobster

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lobster_ai-1.1.3-py3-none-any.whl.

File metadata

  • Download URL: lobster_ai-1.1.3-py3-none-any.whl
  • Upload date:
  • Size: 1.5 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for lobster_ai-1.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 a1212b6d35fb4a8a0a5fa490e90c8a2c20fa42042f395e64641e2a67320f5129
MD5 1290f464d5f05cc0d3de3b36b67df36c
BLAKE2b-256 3552698ba5188cf8c66b709f3633842ef449417dac7061b418728b3f4933fb96

See more details on using hashes here.

Provenance

The following attestation bundles were made for lobster_ai-1.1.3-py3-none-any.whl:

Publisher: publish-packages.yml on the-omics-os/lobster

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page