Skip to main content

Biotope

PyPI Python Documentation License

Biotope is a framework that helps your AI agents build and maintain purpose-driven knowledge representations. Imagine you need to build a knowledge graph that uses messy clinical data to find promising drug targets, or maintain a database of all people, events, and resources of a distributed organisation. You give raw data and the purpose statement to the Biotope agent, and it builds the graph topology, the mappings, and the entity and conflict resolution, following industry best practices. Biotope simplifies building and maintaining the data project, but semantic authority and final decisions on the representation stay with the human.

How data projects created by the Biotope agent work:

  • Inputs. Structured files are described automatically using croissant-baker: CSV, TSV, Excel, Parquet, JSON, HDF5 and AnnData, FHIR, VCF, BAM, FASTA, DICOM, NIfTI, images and more. Unstructured documents, such as papers and web pages, become records through an extractor the agent writes, and each value keeps the quote it came from.
  • Output. Neo4j import files or one SQLite file. Every node and edge names the source rows it came from.
  • Maintainability. The data project is plain Python in a fixed layout, with static type checking for all entities and mappings. New data of the same shape rebuilds with commands only, and a change in the data's structure is reported before the build.
  • Versioning. Everything Biotope writes is a plain file that you commit with your own git. Each build records its code, data revisions and library versions.

Get started

You need uv and a coding agent, such as Claude Code, Codex, Cursor or OpenCode.

  1. Install the Biotope plugin. In Claude Code, add the Biotope marketplace and install it:

    /plugin marketplace add biocypher/biotope#biotope-v1.0.2
    /plugin install biotope@biotope
    
  2. Start your agent in your project folder.

  3. Tell it where the data is and what the graph is for:

    Use biotope to build a knowledge graph from the files in data/. It is for our institute's staff, who look up who works on which topic, in which group and on which projects.

The agent installs Biotope into the project's own environment, agrees the purpose with you and asks for the decisions only you can make. Get started walks through each step, including the setup for other agents.

Documentation

Contribute

See CONTRIBUTING.md. Report problems through GitHub issues.

Typed authoring and modular topology construction were informed by Paul Ka Po To's kg-build-system. Biotope does not depend on that engine.

Copyright © 2025–2026 BioCypher Team. Apache 2.0.

Metadata

Release files for biotope 1.0.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 biotope 1.0.2
File Size Uploaded Provenance Actions
biotope-1.0.2.tar.gz 530.6 kB With provenance Details for biotope-1.0.2.tar.gz

Built distribution (wheel)

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

Total release size: 798.1 kB

Release files / biotope-1.0.2.tar.gz

Download URL biotope-1.0.2.tar.gz
Size 530.6 kB
Tags Source
SHA-256 checksum
How to use checksums
55c5784b9679071609b19ed84006192ced4d64b0523356aa5deb21e4d257edd4
BLAKE2b-256 checksum
How to use checksums
b6316eb55acb2c3f1262ffb332a63111f9fde47f0b49b3a60d39098adc053e21
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 10, 2026.

Transparency log

Release files / biotope-1.0.2-py3-none-any.whl

Download URL biotope-1.0.2-py3-none-any.whl
Size 267.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7609e68b0a6c7e108e2cfcdb8086f61c8c407db152f4311f7ef3df287cc174c3
BLAKE2b-256 checksum
How to use checksums
f2ee2d96950c45b26cd3c412301365f2decd11efb416cac39d3ae06bfa43ae97
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 10, 2026.

Transparency log

Security for biotope 1.0.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 biotope-1.0.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 10, 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.

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