context-use 0.3.1

Turn your data exports into portable AI memory.

context-use

Turn your data exports into portable AI memory.

Install

pip install context-use
# or
uv tool install context-use

Quick start

Quickly extract memories (last 30 days) from your data export:

context-use pipeline --quick <your-zipped-data-export>

[!IMPORTANT] You must have an export from any of the supported providers to use this command.

The quickstart mode uses the real-time API of the LLM provider — fast for small slices but susceptible to rate limits on large exports. Use the Full pipeline to process the complete data export without incurring in rate limits.

Full pipeline

For full data export and cost-efficient batch processing.

context-use pipeline

Ingests the export and generates memories via the batch API of the LLM provider — 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

1. Follow the export guide for your provider in the supported providers table. The export is delivered as a ZIP file — do not extract it.
2. Move or copy the ZIP into context-use-data/input/:

context-use-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
Instagram	Available	Stories, Reels, Posts, Likes, Followers, ...	Export your data
Google	Coming soon	Searches, YouTube	Export your data
WhatsApp	Coming soon	Conversations	Export your data