ligandai 0.1.0__tar.gz

ligandai-0.1.0/.gitignore

@@ -0,0 +1,58 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg
+*.egg-info/
+.eggs/
+build/
+dist/
+wheels/
+*.whl
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Testing / coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+.hypothesis/
+
+# Type checking
+.mypy_cache/
+.pytype/
+.ruff_cache/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Docs build
+docs/_build/
+docs/api/
+
+# Local secrets / config
+.env
+.env.local
+*.pem
+secrets.json
+
+# Build artifacts
+*.log

ligandai-0.1.0/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [0.1.0] - 2025
+
+### Added
+
+- Initial public release.
+- Sync (`LigandAI`) and async (`AsyncLigandAI`) clients.
+- Tier detection from API key prefix (`lgai_free_*`, `lgai_edu_*`,
+  `lgai_pro_*`, `lgai_ent_*`, `lgai_sa_*`). No network call required.
+- Twelve resource namespaces:
+  - `account`, `receptors`, `structures`, `proteins`, `discovery`,
+    `diseases`, `peptides`, `bivalent`, `synthesis`, `memory`,
+    `programs`, `charts`, `reports`, `jobs`.
+- `Job` / `AsyncJob` polymorphic abstractions for long-running operations
+  with `.wait()`, `.poll()`, `.cancel()`, `.stream()` (SSE).
+- Typed exception hierarchy: `LigandAIError`, `LigandAIAuthError`,
+  `LigandAITierError`, `LigandAIRateLimitError`, `LigandAICreditError`,
+  `LigandAINotFoundError`, `LigandAIServerError`, `LigandAIValidationError`,
+  `LigandAIJobError`, `LigandAITimeoutError`, `NotSupportedOnReceptorDB`.
+- Pydantic v2 models for every documented request/response field.
+- `httpx` transport with auto-retry on 429/5xx via `tenacity`,
+  exponential backoff, and `Retry-After` / `X-RateLimit-Reset` parsing.
+- `ReceptorDBClient` and `AsyncReceptorDBClient` with the read-mostly
+  ReceptorDB subset; raises `NotSupportedOnReceptorDB` for endpoints
+  outside the subset.
+- Tier feature-gating raised client-side (no round-trip) for known features.
+- Six example scripts in `examples/`.
+- Sphinx docs scaffold (`docs/`).
+
+### Server endpoint mapping
+
+The SDK targets `/api/*` routes (NOT `/v1/*`). Express's `isAuthenticated`
+middleware accepts either a session cookie OR `Authorization: Bearer lgai_*`
+on every `/api/*` route, so the SDK uses Bearer auth uniformly.
+
+The `/v1/*` enterprise routes have feature gaps (no bivalent, no synthesis
+cart, no charts) and use an in-memory `apiKeyStore` map rather than the
+canonical Drizzle `apiKeys` table. See `wiki/synthesis/api_endpoints_complete_catalog.md:498`
+for details.

ligandai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ligandal, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ligandai-0.1.0/PKG-INFO

@@ -0,0 +1,275 @@
+Metadata-Version: 2.4
+Name: ligandai
+Version: 0.1.0
+Summary: Official Python SDK for the LIGANDAI® platform — peptide design, structure prediction, scoring, and discovery.
+Project-URL: Homepage, https://ligandai.com
+Project-URL: Documentation, https://docs.ligandai.com
+Project-URL: Repository, https://github.com/ligandal/ligandai-python-sdk
+Project-URL: Issues, https://github.com/ligandal/ligandai-python-sdk/issues
+Project-URL: Changelog, https://github.com/ligandal/ligandai-python-sdk/blob/main/CHANGELOG.md
+Author-email: Andre Watson <dre@ligandal.com>
+License: MIT
+License-File: LICENSE
+Keywords: bioinformatics,boltz2,computational-biology,deltaforge,drug-discovery,ligandai,ligandforge,peptide-design,protein-folding
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
+Classifier: Topic :: Scientific/Engineering :: Chemistry
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx<1.0,>=0.27
+Requires-Dist: pydantic<3.0,>=2.0
+Requires-Dist: tenacity<10.0,>=8.0
+Requires-Dist: typing-extensions>=4.5
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: myst-parser>=2.0; extra == 'docs'
+Requires-Dist: sphinx-autoapi>=3.0; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme>=2.0; extra == 'docs'
+Requires-Dist: sphinx>=7.0; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# LIGANDAI Python SDK
+
+Official Python SDK for the [LIGANDAI](https://ligandai.com) platform — peptide
+design, structure prediction, scoring, and discovery.
+
+```bash
+pip install ligandai
+```
+
+```python
+from ligandai import LigandAI
+
+client = LigandAI(api_key="lgai_pro_...")
+print(f"Tier: {client.tier}, Credits: {client.credits}")
+
+# Find tissue-specific surface markers
+markers = client.discovery.tissue_markers(target_tissues=["Liver"], top_n=2000)
+
+# Resolve a structure for the top marker
+gene = markers.top[0].gene
+structure = client.structures.get(gene)
+analysis = client.structures.analyze(gene, analysis_depth="full")
+
+# Generate peptides targeting the recommended pocket
+job = client.peptides.generate(
+    gene=gene,
+    num_peptides=300,
+    target_residues=[analysis.recommended_pocket] if analysis.recommended_pocket else None,
+    targeting_strategy="pocket_targeted",
+    auto_fold=True,
+    top_n_fold=25,
+)
+
+# Wait for completion (generation + auto-fold)
+result = job.wait(timeout=1800)
+print(f"Got {len(result.peptides)} peptides, top iPSAE: {result.peptides[0].ipsae}")
+```
+
+## Authentication
+
+```python
+# 1. Pass explicitly
+client = LigandAI(api_key="lgai_pro_...")
+
+# 2. Read from env var (preferred for prod)
+# $ export LIGANDAI_API_KEY=lgai_pro_...
+client = LigandAI()
+
+# 3. Custom base URL (dev / on-prem / enterprise)
+client = LigandAI(api_key="...", base_url="http://localhost:5050")
+```
+
+API keys carry a **tier prefix**:
+
+| Prefix | Tier | What it can do |
+|---|---|---|
+| `lgai_free_*` | free | search, view structures, get job status |
+| `lgai_edu_*`  | academia | + generate, fold, score, glycosylation |
+| `lgai_pro_*`  | pro | + bivalent, transport vasculome (no batch ops) |
+| `lgai_ent_*`  | enterprise | everything + batch operations + priority queue |
+| `lgai_sa_*`   | superadmin | all features (internal) |
+
+The client detects the tier from the prefix at construction — no network call.
+
+```python
+client.tier                     # "pro"
+client.credits                  # int
+client.feature_allowed("...")   # bool
+client.max_peptides_per_generation
+client.rate_limit_per_minute
+```
+
+When a method requires a higher tier than the key carries, it raises
+`LigandAITierError` **client-side**, before sending the request.
+
+## Resource Namespaces
+
+| Namespace | Endpoints | What it does |
+|---|---|---|
+| `client.account`       | `/api/auth/user`, `/api/user-credits`, ... | profile, credits, tier limits |
+| `client.receptors`     | `/api/receptordb/*` | search, browse, download PDBs |
+| `client.structures`    | `/api/structure/*`, `/api/gene-resolver/*` | gene → PDB / AlphaFold |
+| `client.proteins`      | `/api/protein-info/*`, `/api/protein-variants/*` | UniProt info, variants, custom PDBs |
+| `client.discovery`     | `/api/transcriptomics/*`, `/api/scrna/*`, `/api/geo-import/*` | tissue markers, scRNA, GEO import |
+| `client.diseases`      | `/api/disease-viewer/*` | disease search, mutations |
+| `client.peptides`      | `/api/ptf/parallel/*`, `/api/folding/*`, `/api/binder-scoring/*` | generate, fold, score |
+| `client.bivalent`      | `/api/ligandforge/bivalent/*` | bispecific design (pro+) |
+| `client.synthesis`     | `/api/synthesis-checkout/*`, `/api/adaptyv/*` | quote, cart, order |
+| `client.memory`        | `/api/episodic-memory/*` | memory search & save |
+| `client.programs`      | `/api/ptf/programs/*`, `/api/ptf/sessions/*` | programs, projects, sessions |
+| `client.charts`        | `/api/charts/*` | matplotlib chart generation |
+| `client.reports`       | `/api/reports/*` | PDF report generation |
+| `client.jobs`          | `/api/jobs/*` | list, cancel, stream |
+
+## Long-Running Jobs
+
+Generation, folding, and scoring submit GPU work and return a `Job`:
+
+```python
+job = client.peptides.generate(gene="EGFR", num_peptides=300)
+job.id              # str
+job.status          # "queued" | "running" | "complete" | "failed"
+job.progress        # 0-100 or None
+job.estimated_credits
+
+# Block until done
+result = job.wait(timeout=1800, poll_interval=2.0)
+
+# Or stream live progress events (SSE)
+for event in job.stream():
+    print(f"{event.stage}: {event.message} ({event.progress})")
+
+# Cancel
+job.cancel()
+```
+
+Async equivalents:
+
+```python
+import asyncio
+from ligandai import AsyncLigandAI
+
+async def design_for_genes(genes):
+    async with AsyncLigandAI() as client:
+        jobs = await asyncio.gather(*[
+            client.peptides.generate(gene=g, num_peptides=300) for g in genes
+        ])
+        results = await asyncio.gather(*[j.wait() for j in jobs])
+        return results
+
+results = asyncio.run(design_for_genes(["EGFR", "HER2", "KIT"]))
+```
+
+## Errors
+
+```python
+from ligandai import (
+    LigandAIError,           # base
+    LigandAIAuthError,       # 401 — invalid/expired/revoked key
+    LigandAITierError,       # 403 — feature requires higher tier
+    LigandAIRateLimitError,  # 429 — rate limit
+    LigandAICreditError,     # 402 — insufficient credits
+    LigandAINotFoundError,   # 404
+    LigandAIServerError,     # 5xx (auto-retried)
+    LigandAIValidationError, # 400/422
+)
+
+try:
+    job = client.peptides.generate(gene="EGFR", num_peptides=10000)
+except LigandAITierError as e:
+    print(f"Need {e.required_tier}, you have {e.current_tier}")
+except LigandAICreditError as e:
+    print(f"Need {e.required} credits, have {e.available}")
+```
+
+## Retry & Rate Limiting
+
+The SDK automatically retries on `429`, `5xx`, and transient network errors
+with exponential backoff (configurable via `max_retries=`). It also respects
+`Retry-After` and `X-RateLimit-Reset` headers.
+
+Per-tier rate limits:
+
+| Tier | req/min |
+|---|---|
+| free | 10 |
+| academia | 30 |
+| pro | 60 |
+| enterprise | 300 |
+
+## ReceptorDB-restricted Client
+
+For receptordb.com users, a thinner client exposes only browse / search /
+download (no API key required for read endpoints):
+
+```python
+from ligandai import ReceptorDBClient
+
+client = ReceptorDBClient()
+hits = client.search("EGFR")
+client.download_pdb(hits[0].complex_id, "egfr.pdb")
+
+# With API key — fold/generate
+client = ReceptorDBClient(api_key="lgai_basic_...")
+job = client.fold(sequences=["MAEEPQSD..."], target_gene="EGFR")
+```
+
+## Typed Models
+
+All request/response shapes are pydantic models. IDE autocompletion works
+out of the box, including for nested fields:
+
+```python
+from ligandai import BivalentTarget, LinkerConfig
+
+session = client.bivalent.start(
+    target1=BivalentTarget(gene="PDCD1", chain="A"),
+    target2=BivalentTarget(gene="CD274", chain="A"),
+    linker=LinkerConfig(position="C", length_min=8, length_max=20),
+    binder_length_min=15,
+    binder_length_max=40,
+    num_designs=200,
+)
+print(session.id, session.status)
+```
+
+## Examples
+
+See `examples/` for complete worked demos:
+
+- `examples/01_quickstart.py` — auth, tier check, simple search
+- `examples/02_end_to_end.py` — discovery → structure → generate → fold → score → cart
+- `examples/03_bivalent.py` — PD-1 / PD-L1 bispecific design
+- `examples/04_async_parallel.py` — design for many genes concurrently
+- `examples/05_custom_variant.py` — fold a mutation, save as variant, regenerate
+- `examples/06_streaming.py` — live SSE progress
+
+## Development
+
+```bash
+git clone https://github.com/ligandal/ligandai-python-sdk
+cd ligandai-python-sdk
+pip install -e ".[dev]"
+pytest
+mypy ligandai/
+ruff check ligandai/
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

ligandai-0.1.0/README.md

@@ -0,0 +1,231 @@
+# LIGANDAI Python SDK
+
+Official Python SDK for the [LIGANDAI](https://ligandai.com) platform — peptide
+design, structure prediction, scoring, and discovery.
+
+```bash
+pip install ligandai
+```
+
+```python
+from ligandai import LigandAI
+
+client = LigandAI(api_key="lgai_pro_...")
+print(f"Tier: {client.tier}, Credits: {client.credits}")
+
+# Find tissue-specific surface markers
+markers = client.discovery.tissue_markers(target_tissues=["Liver"], top_n=2000)
+
+# Resolve a structure for the top marker
+gene = markers.top[0].gene
+structure = client.structures.get(gene)
+analysis = client.structures.analyze(gene, analysis_depth="full")
+
+# Generate peptides targeting the recommended pocket
+job = client.peptides.generate(
+    gene=gene,
+    num_peptides=300,
+    target_residues=[analysis.recommended_pocket] if analysis.recommended_pocket else None,
+    targeting_strategy="pocket_targeted",
+    auto_fold=True,
+    top_n_fold=25,
+)
+
+# Wait for completion (generation + auto-fold)
+result = job.wait(timeout=1800)
+print(f"Got {len(result.peptides)} peptides, top iPSAE: {result.peptides[0].ipsae}")
+```
+
+## Authentication
+
+```python
+# 1. Pass explicitly
+client = LigandAI(api_key="lgai_pro_...")
+
+# 2. Read from env var (preferred for prod)
+# $ export LIGANDAI_API_KEY=lgai_pro_...
+client = LigandAI()
+
+# 3. Custom base URL (dev / on-prem / enterprise)
+client = LigandAI(api_key="...", base_url="http://localhost:5050")
+```
+
+API keys carry a **tier prefix**:
+
+| Prefix | Tier | What it can do |
+|---|---|---|
+| `lgai_free_*` | free | search, view structures, get job status |
+| `lgai_edu_*`  | academia | + generate, fold, score, glycosylation |
+| `lgai_pro_*`  | pro | + bivalent, transport vasculome (no batch ops) |
+| `lgai_ent_*`  | enterprise | everything + batch operations + priority queue |
+| `lgai_sa_*`   | superadmin | all features (internal) |
+
+The client detects the tier from the prefix at construction — no network call.
+
+```python
+client.tier                     # "pro"
+client.credits                  # int
+client.feature_allowed("...")   # bool
+client.max_peptides_per_generation
+client.rate_limit_per_minute
+```
+
+When a method requires a higher tier than the key carries, it raises
+`LigandAITierError` **client-side**, before sending the request.
+
+## Resource Namespaces
+
+| Namespace | Endpoints | What it does |
+|---|---|---|
+| `client.account`       | `/api/auth/user`, `/api/user-credits`, ... | profile, credits, tier limits |
+| `client.receptors`     | `/api/receptordb/*` | search, browse, download PDBs |
+| `client.structures`    | `/api/structure/*`, `/api/gene-resolver/*` | gene → PDB / AlphaFold |
+| `client.proteins`      | `/api/protein-info/*`, `/api/protein-variants/*` | UniProt info, variants, custom PDBs |
+| `client.discovery`     | `/api/transcriptomics/*`, `/api/scrna/*`, `/api/geo-import/*` | tissue markers, scRNA, GEO import |
+| `client.diseases`      | `/api/disease-viewer/*` | disease search, mutations |
+| `client.peptides`      | `/api/ptf/parallel/*`, `/api/folding/*`, `/api/binder-scoring/*` | generate, fold, score |
+| `client.bivalent`      | `/api/ligandforge/bivalent/*` | bispecific design (pro+) |
+| `client.synthesis`     | `/api/synthesis-checkout/*`, `/api/adaptyv/*` | quote, cart, order |
+| `client.memory`        | `/api/episodic-memory/*` | memory search & save |
+| `client.programs`      | `/api/ptf/programs/*`, `/api/ptf/sessions/*` | programs, projects, sessions |
+| `client.charts`        | `/api/charts/*` | matplotlib chart generation |
+| `client.reports`       | `/api/reports/*` | PDF report generation |
+| `client.jobs`          | `/api/jobs/*` | list, cancel, stream |
+
+## Long-Running Jobs
+
+Generation, folding, and scoring submit GPU work and return a `Job`:
+
+```python
+job = client.peptides.generate(gene="EGFR", num_peptides=300)
+job.id              # str
+job.status          # "queued" | "running" | "complete" | "failed"
+job.progress        # 0-100 or None
+job.estimated_credits
+
+# Block until done
+result = job.wait(timeout=1800, poll_interval=2.0)
+
+# Or stream live progress events (SSE)
+for event in job.stream():
+    print(f"{event.stage}: {event.message} ({event.progress})")
+
+# Cancel
+job.cancel()
+```
+
+Async equivalents:
+
+```python
+import asyncio
+from ligandai import AsyncLigandAI
+
+async def design_for_genes(genes):
+    async with AsyncLigandAI() as client:
+        jobs = await asyncio.gather(*[
+            client.peptides.generate(gene=g, num_peptides=300) for g in genes
+        ])
+        results = await asyncio.gather(*[j.wait() for j in jobs])
+        return results
+
+results = asyncio.run(design_for_genes(["EGFR", "HER2", "KIT"]))
+```
+
+## Errors
+
+```python
+from ligandai import (
+    LigandAIError,           # base
+    LigandAIAuthError,       # 401 — invalid/expired/revoked key
+    LigandAITierError,       # 403 — feature requires higher tier
+    LigandAIRateLimitError,  # 429 — rate limit
+    LigandAICreditError,     # 402 — insufficient credits
+    LigandAINotFoundError,   # 404
+    LigandAIServerError,     # 5xx (auto-retried)
+    LigandAIValidationError, # 400/422
+)
+
+try:
+    job = client.peptides.generate(gene="EGFR", num_peptides=10000)
+except LigandAITierError as e:
+    print(f"Need {e.required_tier}, you have {e.current_tier}")
+except LigandAICreditError as e:
+    print(f"Need {e.required} credits, have {e.available}")
+```
+
+## Retry & Rate Limiting
+
+The SDK automatically retries on `429`, `5xx`, and transient network errors
+with exponential backoff (configurable via `max_retries=`). It also respects
+`Retry-After` and `X-RateLimit-Reset` headers.
+
+Per-tier rate limits:
+
+| Tier | req/min |
+|---|---|
+| free | 10 |
+| academia | 30 |
+| pro | 60 |
+| enterprise | 300 |
+
+## ReceptorDB-restricted Client
+
+For receptordb.com users, a thinner client exposes only browse / search /
+download (no API key required for read endpoints):
+
+```python
+from ligandai import ReceptorDBClient
+
+client = ReceptorDBClient()
+hits = client.search("EGFR")
+client.download_pdb(hits[0].complex_id, "egfr.pdb")
+
+# With API key — fold/generate
+client = ReceptorDBClient(api_key="lgai_basic_...")
+job = client.fold(sequences=["MAEEPQSD..."], target_gene="EGFR")
+```
+
+## Typed Models
+
+All request/response shapes are pydantic models. IDE autocompletion works
+out of the box, including for nested fields:
+
+```python
+from ligandai import BivalentTarget, LinkerConfig
+
+session = client.bivalent.start(
+    target1=BivalentTarget(gene="PDCD1", chain="A"),
+    target2=BivalentTarget(gene="CD274", chain="A"),
+    linker=LinkerConfig(position="C", length_min=8, length_max=20),
+    binder_length_min=15,
+    binder_length_max=40,
+    num_designs=200,
+)
+print(session.id, session.status)
+```
+
+## Examples
+
+See `examples/` for complete worked demos:
+
+- `examples/01_quickstart.py` — auth, tier check, simple search
+- `examples/02_end_to_end.py` — discovery → structure → generate → fold → score → cart
+- `examples/03_bivalent.py` — PD-1 / PD-L1 bispecific design
+- `examples/04_async_parallel.py` — design for many genes concurrently
+- `examples/05_custom_variant.py` — fold a mutation, save as variant, regenerate
+- `examples/06_streaming.py` — live SSE progress
+
+## Development
+
+```bash
+git clone https://github.com/ligandal/ligandai-python-sdk
+cd ligandai-python-sdk
+pip install -e ".[dev]"
+pytest
+mypy ligandai/
+ruff check ligandai/
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

ligandai-0.1.0/examples/01_quickstart.py

@@ -0,0 +1,36 @@
+# Copyright © 2025 Ligandal, Inc. All rights reserved.
+"""Quickstart — auth, tier check, simple search.
+
+Run:
+    LIGANDAI_API_KEY=lgai_pro_... python examples/01_quickstart.py
+"""
+
+from __future__ import annotations
+
+from ligandai import LigandAI
+
+
+def main() -> None:
+    client = LigandAI()  # reads LIGANDAI_API_KEY env var
+
+    # No network call — tier comes from key prefix.
+    print(f"Tier: {client.tier}")
+    print(f"Rate limit: {client.rate_limit_per_minute} req/min")
+    print(f"Max peptides per generation: {client.max_peptides_per_generation}")
+    print()
+
+    # Network call: get user + credits
+    user = client.user
+    print(f"User: {user.email} ({user.first_name} {user.last_name})")
+    print(f"Credits: {client.credits}")
+    print()
+
+    # Search ReceptorDB
+    print("Searching for EGFR receptors...")
+    hits = client.receptors.search("EGFR", limit=5)
+    for h in hits:
+        print(f"  {h.complex_name} — {h.oligomeric_state} ({h.organism})")
+
+
+if __name__ == "__main__":
+    main()