uv
Add the client to a uv-managed project.
uv add fulcra-api
The Life API — a shared context lake, as a Python client
Python is the interface. Your context lake is the product.
A client for the context lake you own. Authenticate once, then read normalized real-world data into your notebook, script, or agent — and write back records, files, and shares that your other agents can build on.
Your account is created the first time you connect, so there is no separate signup. The same package also installs the Fulcra CLI.
Install
Copy
pip install fulcra-api
You & Your Context
Your Agent
Fulcra Python SDK
Fulcra Life API
Fulcra Datastore
Context App
INSTALL
Add the client, however you build.
We've built the fulcra-api python module to make your life easier.
Poetry
Add the client to a Poetry project.
poetry add fulcra-api
Quick start
Working notebooks that authorize, read real data, and chart it — clone and run.
Notebook demos on GitHub →Jupyter
The native library works well in notebooks — open the data-visualization demo and run it against your own lake.
Open the notebook →THE FULL SURFACE
The whole surface, in Python.
This library is the widest surface Fulcra exposes — every method on the FulcraAPI class, including the Data Shares the MCP server does not carry yet. The loop is the same one every agent runs: ask what changed since the last run — including what other agents wrote — read what moved, write back what you learned. The CLI ships in the same package and wraps the parts worth having in a shell.
What changed since the last loop
Ask what changed across a window — which kinds of records arrived and which files moved, including what the user's other agents added — so an agent picks up where it left off rather than starting over. Catalogs cover discovery for everything else.
Record and annotate
Annotations — boolean, numeric, duration, moment and scale — plus tags for organising what you record, and validation before you commit a batch.
Data Shares
Create, update, and revoke a Data Share programmatically, and list the datasets other people have shared with you.
Files are first-class
Upload, download, and restore versioned files that keep their native form — documents, exports, artifacts. Resolve data types and query the catalogs for everything else.
WHERE NEXT
Every method, documented.
The reference covers the whole FulcraAPI class. If you would rather work from a shell, the same package installs a command-line interface.
.png){kind=logo}
