Skip to main content

Turn your data exports into portable AI memory.

Project description

context-use

PyPI - Version

Turn your data exports into portable AI memory.

For Agents

Use the SKILL.md file on how to use context-use to get to personalize your answers to the human.

For Humans

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, Direct Messages, ... Export your data
Google Coming soon Searches, YouTube Export your data
WhatsApp Coming soon Conversations Export your data

Want another provider? Contribute it by pointing your coding agent to the Adding a Data Provider guide.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

context_use-0.4.0.tar.gz (89.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

context_use-0.4.0-py3-none-any.whl (140.1 kB view details)

Uploaded Python 3

File details

Details for the file context_use-0.4.0.tar.gz.

File metadata

  • Download URL: context_use-0.4.0.tar.gz
  • Upload date:
  • Size: 89.3 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

Hashes for context_use-0.4.0.tar.gz
Algorithm Hash digest
SHA256 35160863f9d6dcb1b16cae349c43b7cdacd5edb4c0fe13d938f1f55c3cb5494c
MD5 6ee44b67a13558b0d222bf6015417e64
BLAKE2b-256 d5c33ad72bbcaf5e7bd01a6eac4d059be171bb0fc0cd83fe5a005143a2d9e0ea

See more details on using hashes here.

File details

Details for the file context_use-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: context_use-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 140.1 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

Hashes for context_use-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 db29b41a0fd059957395841b936a37fee9ddc5dd623eeb79c2236ffc3dee914a
MD5 e4b05db1f4d4b715ab47a51d06417358
BLAKE2b-256 f78c93640a2a224a3be88a8b4b5af716c5facc6831461d43e71cd9377a391d95

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page