Skip to main content

BioSynthAI

BioSynthAI is a multi-agent platform for neuroscience and biomedical knowledge synthesis.

It integrates diverse biomedical databases and literature sources to automatically retrieve, analyze, and synthesize scientific knowledge across domains. BioSynthAI aims to support research, discovery, and hypothesis generation by combining structured data, publications, and biological knowledge into unified insights.

Key Features:

  • Multi-agent architecture for modular and scalable analysis
  • Live integration with biomedical databases (PubMed, Gene, UniProt, STRING, and more)
  • Automated literature retrieval and synthesis
  • Knowledge graph construction and enrichment
  • Support for neuroscience and broader biomedical research workflows
  • Local caching and conversation-aware memory

Note: Still in active development.

Databases integrated

Database What it provides
PubMed / PMC Literature + full text
NCBI Gene Gene info, GO terms, RefSeq
NLM MeSH API Dynamic MeSH term resolution
bioRxiv Recent preprints
STRING Protein interactions + pathway enrichment
UniProt Protein function, domains, diseases
Open Targets Drug-target-disease associations
DANDI Archive Neurophysiology datasets (NWB)
Allen Brain Atlas Brain region gene expression
NeuroMorpho.Org Neuron morphology reconstructions
ClinVar Variant counts

Installation

From PyPI

pip install biosynthai

From source (development)

git clone https://github.com/tekrajchhetri/biosynthai.git
cd biosynthai
pip install -e .

Usage

CLI (after pip install)

biosynthai "What does BDNF do in the hippocampus?"

# Pass API key directly (no .env needed)
biosynthai "BDNF hippocampus" --api-key sk-or-v1-...

# With NCBI key for higher PubMed rate limits
biosynthai "BDNF hippocampus" --api-key sk-or-v1-... --ncbi-key abc123

# Specify model
biosynthai "SNCA in Parkinson's disease" --model google/gemini-2.5-flash

# More results, deeper related-article expansion
biosynthai "hippocampus theta oscillations" --max-results 20 --depth 2

# Skip some databases
biosynthai "MAPT tau aggregation" --no-dandi --no-neuromorpho

# Export specific format
biosynthai "dopamine reward circuits" --format json --output results/

# Version
biosynthai --version

You can also run via python -m biosynthai "..." or python main.py "..." from the repo root.

Python API

import asyncio
from biosynthai import BioSynthesizer, BioSearchQuery

synth = BioSynthesizer(api_key="sk-or-v1-...")
query = BioSearchQuery(question="What does BDNF do in the hippocampus?")
result = await synth.run(query)

print(result.synthesis_text)
print(f"Articles: {len(result.articles)}")
print(f"DANDI datasets: {len(result.dandi_datasets)}")

Environment variables

Variable Required Description
OPENROUTER_API_KEY Yes Get one at openrouter.ai/keys
NCBI_API_KEY No Raises PubMed rate limit 3 → 10 req/s

All keys can also be passed via CLI flags (--api-key, --ncbi-key), which take priority over environment variables.

Changing the model

Any model available on OpenRouter works:

biosynthai "BDNF" --model anthropic/claude-sonnet-4       # default
biosynthai "BDNF" --model anthropic/claude-haiku-4        # faster/cheaper
biosynthai "BDNF" --model google/gemini-2.5-pro
biosynthai "BDNF" --model openai/gpt-4o
biosynthai "BDNF" --model deepseek/deepseek-chat

Package structure

biosynthai/
├── __init__.py      # Public API
├── models.py        # Pydantic v2 models
├── agents.py        # pydantic-ai agents (search plan, synthesis, profile)
├── clients.py       # All database clients (PubMed, STRING, DANDI …)
├── pipeline.py      # BioSynthesizer orchestrator
├── evidence.py      # Heuristic evidence extraction
├── export.py        # Markdown / JSON / BibTeX export
├── main.py          # CLI entry point (biosynthai command)
└── __main__.py      # python -m biosynthai support

pydantic-ai agents

Agent Output type Purpose
search_plan_agent BioSearchPlan Generates structured search strategy
synthesis_agent str Grounded narrative synthesis
evidence_extraction_agent BatchEvidenceExtraction Extracts evidence spans
friendly_profile_agent FriendlyProfile Human-friendly gene profile

All agents use defer_model_check=True so the model is injected at runtime, making FastAPI integration straightforward.

License

Apache 2.0 — © 2026 Tek Raj Chhetri

Metadata

Release files for biosynthai 0.1.0

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

Source distribution (sdist)

Source distribution for biosynthai 0.1.0
File Size Uploaded Provenance Actions
biosynthai-0.1.0.tar.gz 25.4 kB Without provenance Details for biosynthai-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for biosynthai 0.1.0
File Interpreter ABI Platform Actions
biosynthai-0.1.0-py3-none-any.whl Python 3 none any Details for biosynthai-0.1.0-py3-none-any.whl

Total release size: 55.1 kB

Release files / biosynthai-0.1.0.tar.gz

Download URL biosynthai-0.1.0.tar.gz
Size 25.4 kB
Tags Source
SHA-256 checksum
How to use checksums
ffed730b7b505efa49f78e86bdc0630c85bd41259caa3860eab4e7f3c7acb536
BLAKE2b-256 checksum
How to use checksums
65ce0e2588a33f3538ffb5c25428a9b55027f10657e2ccb17294b33e567d2b3d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via Hatch/1.16.5 cpython/3.13.5 HTTPX/0.28.1

Release files / biosynthai-0.1.0-py3-none-any.whl

Download URL biosynthai-0.1.0-py3-none-any.whl
Size 29.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c605cf2ecc368be01a078de0bc9215a49feec1a6ca9d877424ebeedb6da8fd3a
BLAKE2b-256 checksum
How to use checksums
fb9d2984727e08418840615ba4234508b290d848313f8c18d464890873ca1a65
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via Hatch/1.16.5 cpython/3.13.5 HTTPX/0.28.1

Security for biosynthai 0.1.0

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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No 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