Turn your data exports into portable AI memory.
Project description
context-use
Turn your data exports into portable AI memory.
Install
pip install context-use
# or
uv tool install context-use
Quick start
A zero-setup preview that requires no database setup.
context-use pipeline --quick
[!IMPORTANT] You must have an export from any of the supported providers to use this command.
The CLI prompts for the export and provider. Memory generation uses the OpenAI real-time API — fast for small slices but susceptible to rate limits on large exports. By default only the last 30 days are processed; use --full to include the complete history (the CLI warns you before proceeding).
Full pipeline
For full archive history and cost-efficient batch processing.
context-use pipeline
Ingests the export and generates memories via the OpenAI batch API — significantly cheaper and more rate-limit-friendly than the real-time API used by quickstart. Typical runtime: 2–10 minutes. Memories are stored in SQLite and persist across sessions, enabling semantic search and the personal agent.
Explore your memories
context-use memories list
context-use memories search "hiking trips in 2024"
context-use memories export
Personal agent
A multi-turn agent that operates over your full memory store.
context-use agent synthesise # generate higher-level pattern memories
context-use agent profile # compile a first-person profile
context-use agent ask "What topics do I keep coming back to across all my conversations?"
Configuration
There are a bunch of options you can configure:
context-use config --help
The configuration is saved in a config file at <your-home-directory>/.config/context-use/config.toml.
Getting your export
- Follow the export guide for your provider in the supported providers table. The export is delivered as a ZIP file — do not extract it.
- Move or copy the ZIP into
data/input/:
data/
└── input/
└── your-data-export.zip ← place it here
Supported providers
| Provider | Status | Data types | Export guide |
|---|---|---|---|
| ChatGPT | Available | Conversations | Export your data |
| Claude | Available | Conversations | Export your data |
| Available | Stories, Reels, Posts, Likes, Followers, ... | Export your data | |
| Coming soon | Searches, YouTube | Export your data | |
| Coming soon |
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file context_use-0.2.0.tar.gz.
File metadata
- Download URL: context_use-0.2.0.tar.gz
- Upload date:
- Size: 83.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5a8fc5652b0be0905785ace9997afed209de79f49136283d624a09312eb633e9
|
|
| MD5 |
05df2f7f7b28931a28eb69f5d39b9271
|
|
| BLAKE2b-256 |
f94ed1ad7ac95c3b12ba2a8fe8005262f95445cbd18028dff47547f0fe05abdb
|
File details
Details for the file context_use-0.2.0-py3-none-any.whl.
File metadata
- Download URL: context_use-0.2.0-py3-none-any.whl
- Upload date:
- Size: 133.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3f876c10a47670caa106b19f46d17be47ceae8734fe798fcb0ca12968e207cf1
|
|
| MD5 |
c64a1b5bb7faa4565f0bc9927df3371e
|
|
| BLAKE2b-256 |
0c942d559b971f7f33010d53668074e9596fd03279610449608f6e127cdab6a6
|
