Skip to main content

lobster-research

Literature discovery and data acquisition agents for scientific research workflows.

Installation

pip install lobster-research

Agents

Agent Description
research_agent Literature discovery specialist. PubMed/bioRxiv search, GEO/SRA dataset discovery, metadata extraction, publication queue management.
data_expert_agent Data operations specialist. Queue-based downloads, modality management, local file loading, workspace orchestration.

Services

Service Purpose
ModalityDetectionService Auto-detect data modality type from file characteristics

Features

Research Agent (Online Operations)

  • PubMed literature search with filters and related paper discovery
  • bioRxiv and medRxiv preprint search with full-text access
  • GEO dataset discovery with organism and platform filtering
  • SRA run metadata extraction and download URL generation
  • PRIDE proteomics repository integration
  • Full-text content extraction from PMC articles
  • Methods section parsing for computational parameter discovery
  • Publication queue for batch processing of research papers
  • Automatic extraction of associated dataset identifiers

Data Expert Agent (Offline Operations)

  • Execute downloads from pre-validated queue entries
  • No online searches: works from queue entries prepared by the research agent
  • Multi-format file loading (CSV, TSV, H5AD, Excel)
  • Modality listing, inspection, and validation
  • Download strategy selection (AUTO, H5_FIRST, MATRIX_FIRST)
  • Sample concatenation with union or intersection logic
  • Failed download retry with exponential backoff
  • Custom Python code execution for edge cases

Platform Support

  • 10x Genomics MTX format (matrix, barcodes, features)
  • H5AD pre-processed AnnData files
  • Kallisto and Salmon bulk RNA-seq quantification
  • CSV and TSV generic delimited matrices
  • MaxQuant, Olink, and generic proteomics formats

Architecture

The research and data_expert agents implement a clean boundary pattern:

research_agent (ONLINE)              data_expert (OFFLINE)
-- Search literature                 -- Execute downloads
-- Discover datasets                 -- Load local files
-- Extract metadata/URLs             -- Manage modalities
-- Validate metadata                 -- Retry failed downloads
-- Create queue entries              -- Concatenate samples
         |                                    |
         ----------- Queue Entry -------------
                   (PENDING -> IN_PROGRESS -> COMPLETED)

Requirements

  • Python 3.12+
  • lobster-ai >= 1.0.0

Documentation

Full documentation: docs.omics-os.com/docs/agents/research

License

MIT

Metadata

Release files for lobster-research 1.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lobster-research 1.2.2
File Size Uploaded Provenance Actions
lobster_research-1.2.2.tar.gz 72.9 kB With provenance Details for lobster_research-1.2.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for lobster-research 1.2.2
File Interpreter ABI Platform Actions
lobster_research-1.2.2-py3-none-any.whl Python 3 none any Details for lobster_research-1.2.2-py3-none-any.whl

Total release size: 149.8 kB

Release files / lobster_research-1.2.2.tar.gz

Download URL lobster_research-1.2.2.tar.gz
Size 72.9 kB
Tags Source
SHA-256 checksum
How to use checksums
e404049a8abad0a4c81bf8a63974117669c0e9661fb00a1a48569beccce2ba50
BLAKE2b-256 checksum
How to use checksums
ed0480e94e925b4c0afc6fa2404edfbbdedf2e7a83dee7654c50231b4a3cb525
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.

Transparency log

Release files / lobster_research-1.2.2-py3-none-any.whl

Download URL lobster_research-1.2.2-py3-none-any.whl
Size 76.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1b0aaba7ed62e1e323c090c3fec7c658986afe38c0c5cd02ba4d97d178af6452
BLAKE2b-256 checksum
How to use checksums
4d8887e10b7f43e750d689909fb8c7630110c39bde79ff5b625495c3d6f61a23
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.

Transparency log

Security for lobster-research 1.2.2

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for lobster_research-1.2.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.

Transparency log

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.

Release history Release notifications | RSS feed

This release

1.2.2 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page