The Fulcra Platform¶
Introduction¶
(Expand on introduction blurb and probably a diagram)
Concepts¶
Data Types¶
Data Types semantically describe the things you can record into Fulcra. Your heart rate, step count, the last movie you watched, the people in your contact list, and more. Fulcra provides a bunch of data types out of the box, but if you don't find the right one for what you want to record can also create your own.
Records¶
When you write data of a particular type into Fulcra the saved output is called a record. Records can be returned when you query a data type, and can also be deleted if you record something by accident.
Record Types¶
Each Data Type has an associated Record Type which defines individual fields of what you write into Fulcra and how to interpret them. Fulcra supports the following Record Types:
- Events: Record information about a point in time, or a duration of time.
- Metrics: Record a value over time, like your heart rate, step count, etc.
Sources¶
All Records also have associated source information that describe where the Record came from. Multiple source identifiers can be associated with a Record to create a "chain" of sources which can be useful for expressing relationships between individual sources.
# Denotes a record from a data export written via CLI
{
"id": "906706fc-4f11-415a-a61d-e1c764dd26ee",
"recorded_at": "2025-05-05T00:00:00Z",
"source": ["data.export.1", "com.fulcradynamics.cli"]
}
Tags¶
Records can be associated with configurable tags, which can also be filtered on when querying a Data Type.
Catalog¶
The Catalog is a list of all Data Types provided by Fulcra, your own personal Data Types, and any Data Types shared with you by other users.
Files¶
Fulcra can be used as a secure file store. You can upload files to Fulcra, access them from your devices, and securely share them between your AI agents. Files are versioned and can be easily restored. Just like Records, all Files are encrypted at rest with a unique key.