Metadata-Version: 2.4
Name: context-use
Version: 0.2.0
Summary: Turn your data exports into portable AI memory.
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: google-adk>=1.26
Requires-Dist: ijson>=3.0
Requires-Dist: litellm>=1.81.13
Requires-Dist: pydantic>=2.0
Requires-Dist: sqlite-vec>=0.1.6
Requires-Dist: tenacity>=9.1.4
Provides-Extra: gcs
Requires-Dist: google-cloud-storage<3,>=2.10.0; extra == 'gcs'
Description-Content-Type: text/markdown

# context-use

![PyPI - Version](https://img.shields.io/pypi/v/context-use)

Turn your data exports into portable AI memory.

## Install

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

## Quick start

A zero-setup preview that requires no database setup.

```bash
context-use pipeline --quick
```

> [!IMPORTANT]
> You must have an [export](#getting-your-export) from any of the [supported providers](#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.

```bash
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**

```bash
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.

```bash
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:

```bash
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](#supported-providers) table. The export is delivered as a ZIP file — **do not extract it**.
2. 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](https://help.openai.com/en/articles/7260999-how-do-i-export-my-chatgpt-history-and-data) |
| Claude | Available | Conversations | [Export your data](https://privacy.claude.com/en/articles/9450526-how-can-i-export-my-claude-data) |
| Instagram | Available | Stories, Reels, Posts, Likes, Followers, ... | [Export your data](https://help.instagram.com/181231772500920) |
| Google | Coming soon | Searches, YouTube | [Export your data](https://support.google.com/accounts/answer/3024190) |
| WhatsApp | Coming soon | | |
