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.7.0.tar.gz (108.7 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.7.0-py3-none-any.whl (201.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: context_use-0.7.0.tar.gz
  • Upload date:
  • Size: 108.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","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.7.0.tar.gz
Algorithm Hash digest
SHA256 e23e765ba933c497ac73e70c555957585c8722c13e0e7b27fd923c87f84c86b4
MD5 4afe4f52ceefbf2d7c29c60f43751dfe
BLAKE2b-256 f833fda3bf4a85b49afcda91f0b5327ab133b56d2e26d20fe5338c4249ede3b0

See more details on using hashes here.

File details

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

File metadata

  • Download URL: context_use-0.7.0-py3-none-any.whl
  • Upload date:
  • Size: 201.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","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.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 70c94fcb5f7a854e1f6407550e3351fd0605aa81af580c81ebca6cc53f5096f3
MD5 fcf16fe602bd83a1d153a006d8ebe681
BLAKE2b-256 49f5f0005a5efb3166db207af03321100d45bdb7f710c199dbd9505ed85cb510

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