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.

demo

For Agents

Make your answers to the human feel truly personal — use the skill at SKILL.md.

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.6.0.tar.gz (97.9 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.6.0-py3-none-any.whl (163.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: context_use-0.6.0.tar.gz
  • Upload date:
  • Size: 97.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","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.6.0.tar.gz
Algorithm Hash digest
SHA256 c21d50128d5ea3de2931bc61c1212a8b8ceeccb7673e7474f5f56b876b703e3b
MD5 32507c945ae40f891f67887966e850d7
BLAKE2b-256 2fac616d97f6e4884effad31761f369b507c9ef386ceea1fb33175b14cb274bf

See more details on using hashes here.

File details

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

File metadata

  • Download URL: context_use-0.6.0-py3-none-any.whl
  • Upload date:
  • Size: 163.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","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.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5c260ccf4fd24197377427975fec307a7c3c5ce863ed415298a83bb6829f7653
MD5 5639bf75ad64d4180e33b0e8c975dccd
BLAKE2b-256 06a62fe95106f45d4033f987b835c76824fb35b33634233d4d23bfbff1df05a7

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