Multi-Agent Bioinformatics Analysis System powered by LangGraph
Project description
|
|
Open-source multi-agent bioinformatics engine. Describe your analysis in natural language. |
🧑🔬 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
🤖 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.
🛠️ 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 |
2. The Result |
❓ 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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0d4672bddd4a32a3b5fdd63bb5b697a52cb8f5425b718e692ddee2c94ac20308
|
|
| MD5 |
941ca3aab022fb50c55ea60502f0088f
|
|
| BLAKE2b-256 |
5719a238ae8788991a5c2987101c23a40579859c31cc6025dec3bcce8ef8fab2
|
Provenance
The following attestation bundles were made for lobster_ai-1.1.3.tar.gz:
Publisher:
publish-packages.yml on the-omics-os/lobster
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lobster_ai-1.1.3.tar.gz -
Subject digest:
0d4672bddd4a32a3b5fdd63bb5b697a52cb8f5425b718e692ddee2c94ac20308 - Sigstore transparency entry: 1050524194
- Sigstore integration time:
-
Permalink:
the-omics-os/lobster@4307da55d4afccc108b3692d66cc057aa833f3da -
Branch / Tag:
refs/tags/v1.1.3 - Owner: https://github.com/the-omics-os
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-packages.yml@4307da55d4afccc108b3692d66cc057aa833f3da -
Trigger Event:
push
-
Statement type:
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a1212b6d35fb4a8a0a5fa490e90c8a2c20fa42042f395e64641e2a67320f5129
|
|
| MD5 |
1290f464d5f05cc0d3de3b36b67df36c
|
|
| BLAKE2b-256 |
3552698ba5188cf8c66b709f3633842ef449417dac7061b418728b3f4933fb96
|
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
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lobster_ai-1.1.3-py3-none-any.whl -
Subject digest:
a1212b6d35fb4a8a0a5fa490e90c8a2c20fa42042f395e64641e2a67320f5129 - Sigstore transparency entry: 1050524244
- Sigstore integration time:
-
Permalink:
the-omics-os/lobster@4307da55d4afccc108b3692d66cc057aa833f3da -
Branch / Tag:
refs/tags/v1.1.3 - Owner: https://github.com/the-omics-os
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-packages.yml@4307da55d4afccc108b3692d66cc057aa833f3da -
Trigger Event:
push
-
Statement type: