Metadata-Version: 2.4
Name: infinity-context
Version: 0.2.0
Summary: Reliable memory and context infrastructure for AI coding agents
Author: Infinity Context contributors
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/777genius/infinity-context
Project-URL: Documentation, https://github.com/777genius/infinity-context#readme
Project-URL: Repository, https://github.com/777genius/infinity-context.git
Project-URL: Issues, https://github.com/777genius/infinity-context/issues
Project-URL: Changelog, https://github.com/777genius/infinity-context/releases
Keywords: agents,ai,coding-agents,context,memory,mcp,rag
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: alembic<2.0.0,>=1.18.4
Requires-Dist: asyncpg<1.0.0,>=0.31.0
Requires-Dist: cryptography==50.0.0
Requires-Dist: fastapi<1.0.0,>=0.136.3
Requires-Dist: greenlet<4.0.0,>=3.5.1
Requires-Dist: httpx<1.0.0,>=0.28.1
Requires-Dist: pillow<13.0.0,>=12.2.0
Requires-Dist: pydantic-settings<3.0.0,>=2.14.1
Requires-Dist: pypdf<7.0.0,>=6.13.2
Requires-Dist: sqlalchemy<3.0.0,>=2.0.50
Requires-Dist: uvicorn<1.0.0,>=0.48.0
Provides-Extra: qdrant
Requires-Dist: qdrant-client<2.0.0,>=1.18.0; extra == "qdrant"
Provides-Extra: qdrant-hybrid
Requires-Dist: qdrant-client<2.0.0,>=1.18.0; extra == "qdrant-hybrid"
Requires-Dist: fastembed<1.0.0,>=0.8.0; extra == "qdrant-hybrid"
Provides-Extra: openai
Requires-Dist: openai<3.0.0,>=2.41.1; extra == "openai"
Provides-Extra: graphiti
Requires-Dist: graphiti-core<1.0.0,>=0.29.1; extra == "graphiti"
Provides-Extra: docling
Requires-Dist: docling<3.0.0,>=2.102.1; extra == "docling"
Provides-Extra: asr
Requires-Dist: faster-whisper<2.0.0,>=1.2.1; extra == "asr"
Provides-Extra: s3
Requires-Dist: boto3<2.0.0,>=1.43.32; extra == "s3"
Provides-Extra: cognee
Requires-Dist: cognee<2.0.0,>=1.1.2; extra == "cognee"
Provides-Extra: mcp
Requires-Dist: mcp<2.0.0,>=1.27.1; extra == "mcp"
Provides-Extra: dev
Requires-Dist: aiosqlite<1.0.0,>=0.22.1; extra == "dev"
Requires-Dist: mcp<2.0.0,>=1.27.1; extra == "dev"
Requires-Dist: pytest<10.0.0,>=9.0.3; extra == "dev"
Requires-Dist: ruff<1.0.0,>=0.15.14; extra == "dev"
Dynamic: license-file

# Infinity Context

**Shared project memory for AI agents, with sources you can inspect and changes you can review.**

Keep decisions, documents, and project knowledge available across sessions and
agents. Infinity Context runs on your infrastructure and gives your team one
place to capture knowledge, review updates, and recall relevant context.

[Quickstart](#quickstart) · [Integrations](#integrate-with-your-app) · [Documentation](docs/README.md)

## Why use it?

- **Continue where work left off.** Give a new session the relevant project
  decisions and evidence without copying an entire conversation.
- **Share knowledge across agents.** Connect several coding agents to the same
  memory while keeping projects and threads scoped.
- **Review what becomes memory.** Automatic capture creates suggestions for
  review before promotion to durable knowledge.
- **Follow the source.** Retrieved context includes citations and provenance so
  people and agents can check the evidence.
- **Keep knowledge current.** Updates and forget operations affect canonical
  visibility, even while search indexes catch up.

The everyday loop: **capture → review → recall → update**.
The local UI lets you browse knowledge and review suggestions alongside your
agent workflow.

## Quickstart

Requires **Git, Python 3.11+, and Docker with Compose**.

Download the versioned installer, then connect your agent:

```bash
curl -fsSLo infinity-context-install.sh \
  https://raw.githubusercontent.com/777genius/infinity-context/v0.2.0/scripts/install.sh
bash infinity-context-install.sh --agent codex
```

The installer starts the local stack, configures the requested agent
integration, and opens the memory UI. It reports any integration that still
needs manual setup.

### Supported coding agents

| Agent | Installer option |
| --- | --- |
| Codex | `--agent codex` |
| Claude Code | `--agent claude` |
| Gemini CLI | `--agent gemini` |
| OpenCode | `--agent opencode` |
| Cursor | `--agent cursor` |

Repeat `--agent` to connect several agents, or use `--all-agents`.
Use `--retrieve-only` to enable recall without automatic capture, or
`--no-agent-tools` to keep agent configuration unchanged.

See [installation and first run](docs/public-installation.md) for installation options,
capture controls, and upgrade guidance.

> Upgrading from v0.1.0? Back up the existing Postgres container before
> recreating it. Follow the [data persistence and upgrade notes](docs/public-installation.md#data-persistence-and-v010-upgrades).

## Integrate with your app

Use the HTTP API or an SDK to add memory to an application. Coding agents can
use the MCP server; people can use the CLI and local UI.

| Entry point | Start here |
| --- | --- |
| Python SDK, CLI, and MCP | `pipx install 'infinity-context[mcp]==0.2.0'` |
| TypeScript SDK | [SDK README](packages/infinity_context_ts_sdk/README.md) and [release guide](docs/typescript-sdk-release.md) |
| HTTP API | [API and integration documentation](docs/README.md) |
| Agent tools and resources | [MCP adapter guide](docs/mcp-adapter.md) |

The service and Python package are versioned together at **0.2.0**.
The TypeScript SDK has its own release line, **0.3.2**; follow its release guide
for installation and artifact verification.

For a container deployment:

```bash
docker pull ghcr.io/777genius/infinity-context:0.2.0
```

For development from source:

```bash
git clone https://github.com/777genius/infinity-context.git
cd infinity-context
python3 -m venv .venv
.venv/bin/python -m pip install -e '.[mcp]'
.venv/bin/infinity-context quickstart --agent codex --open-ui
```

## How memory stays trustworthy

Postgres holds the canonical memory state. Optional Qdrant and Graphiti
indexes help find candidates; each result is checked against current scope,
visibility, and lifecycle state before it enters context.

Retrieved memory is rendered as **cited evidence**, never as instructions for
the model. Source references establish provenance; review and judgment are
still needed to decide whether a claim is true.

Read the [architecture and trust model](docs/architecture-and-trust-model.md)
for consistency guarantees, adapter boundaries, and security limits.

## Status

**Alpha, under active development.** APIs and deployment details may change.
Evaluate retrieval quality and operational fit on your own workload before
production use. Current diagnostics do not establish broad answer accuracy or
large-scale production readiness.

Optional adapters have different capability limits; the Graphiti adapter is a
current-state projection. Cognitive memory remains a foundation rather than a
complete runtime feature. For shared deployments, configure access control and
backups using the [deployment guide](docs/self-hosted-team-deployment.md).

## Explore further

- [Documentation index](docs/README.md)
- [Installation and first run](docs/public-installation.md)
- [Self-hosted team deployment](docs/self-hosted-team-deployment.md)
- [Architecture and trust model](docs/architecture-and-trust-model.md)
- [Evaluation evidence and limitations](docs/quality-analysis/memory-quality-e2e-20261022.md)
- [Agent memory capability comparison](docs/competitive/agent-memory-capability-comparison.md)
