Your agents deserve fresh context.

Star us ❤️ → · · ·

CocoIndex turns codebases, meeting notes, inboxes, Slack, PDFs, and videos into live, continuously fresh context for your AI agents and LLM apps to reason over effectively — with minimal incremental processing. Get your production AI agent ready in 10 minutes with reliable, continuously fresh data — no stale batches, no context gap

Incremental · only the delta · Any scale · parallel by default · Declarative · Python, 5 min

Built with CocoIndex ❤️

See all 20+ examples · updated every week →

Get started

pip install -U cocoindex

Declare what should be in your target — CocoIndex keeps it in sync forever, recomputing only the Δ.

import cocoindex as coco
from cocoindex.connectors import localfs, postgres
from cocoindex.ops.text import RecursiveSplitter

@coco.fn(memo=True)                          # ← cached by hash(input) + hash(code)
async def index_file(file, table):
    for chunk in RecursiveSplitter().split(await file.read_text()):
        table.declare_row(text=chunk.text, embedding=embed(chunk.text))

@coco.fn
async def main(src):
    table = await postgres.mount_table_target(PG, table_name="docs")
    table.declare_vector_index(column="embedding")
    await coco.mount_each(index_file, localfs.walk_dir(src).items(), table)

coco.App(coco.AppConfig(name="docs"), main, src="./docs").update_blocking()

Run once to backfill. Re-run anytime — only the changed files re-embed.

Building with an AI coding agent?
Drop in our CocoIndex skill so your agent writes correct v1 code — concepts, APIs, patterns, all in one file.
_{See Use with AI coding agents for install steps.}

React — for data engineering

See the React ↔ CocoIndex mental model →

Incremental engine for long-horizon agents

Data transformation for any engineer, designed for AI workloads —
with a smart incremental engine for always-fresh, explainable data.

Why incremental?

Your agents are only as good as the data they see.
Batch pipelines drift stale. CocoIndex stays live — and only runs the Δ.

$Why incremental? — one illustration combining the four core benefits of CocoIndex's incremental engine. Sub-second fresh (mint): a stopwatch ticking under a second, source changes propagate to the target in under a second so agents see the world as it is, not as it was yesterday. 10× cheaper at scale (yellow): a 10,000-row corpus block where only a thin Δ 0.1% column re-runs and 99.9% stays cached — you skip the other 99.9% of your corpus and pay a fraction of the compute, embedding, and LLM bill. Explainable by default (coral): a lineage thread links a source byte (handbook.md L42) to a target vector — every vector, row, or graph node in the target traces back to its exact source byte for debuggable, auditable, regulator-friendly AI pipelines. Production-grade (purple): a shield stamped with the Rust crab surrounded by retry loops, back-off dots, a DLQ tray, and a no-data-loss check — Rust core with retries, exponential back-off, dead-letter queues, and no-data-loss guarantees, production-ready for long-horizon AI agents. Keywords: incremental indexing, Δ-only reprocessing, sub-second freshness, low-latency RAG, cost-efficient embeddings, data lineage, retrieval-augmented generation, Rust core, retries, back-off, dead letters, no data loss, long-horizon agents.$

What can you build?

See all 20+ examples · updated every week →

Working starters from the examples tree — clone, plug your source, ship.

Share what you build — a banner with a trail of tiny hearts rising from the bottom behind the text, inviting the CocoIndex community to share projects built with the framework

Building something with CocoIndex? We want to see it.
Tag @cocoindex_io on X or drop a link in #showcase on Discord. We'll boost it. 🥥

Community

Read the CocoIndex blog — engineering deep dives, release notes, RAG and knowledge graph tutorials, and case studies

Follow @cocoindex_io on X (formerly Twitter) for release notes, demos, launches, and AI data pipeline updates

We love Contributors — section title banner with a pulsing coral heart badge and cream twinkle sparkles. Every typo fix, new connector, and doc tweak makes CocoIndex better. Keywords: open-source contribution, pull request, typo fix, new connector, good first issue, Hacktoberfest, community, coconut heart.

We are so excited to meet you.
Every typo fix, new connector, doc tweak, or full-on rewrite makes CocoIndex better.
Come hang out — big PRs and small ones, both welcome.

📝 Read the contributing guide · 🐛 good first issues · 💬 Say hi on Discord

CocoIndex Enterprise

Large corpus — built for enterprise scale.

Incremental compute is the only way to keep large corpora fresh without re-embedding them every cycle.
CocoIndex scales from a single repo to petabyte-scale stores — parallel by default, delta-only by design.

Process once. Reconcile forever.

When a source changes, CocoIndex identifies the affected records, propagates the change
across joins and lookups, updates the target, and retires stale rows —
without touching anything that didn't change.

Built on a Rust engine.

The core is Rust — production-grade from day zero.
Parallel chunking, zero-copy transforms where possible, and failure isolation
so one bad record doesn't stall the flow.

_{Apache 2.0 · © CocoIndex contributors 🥥}

Release files for cocoindex 1.0.23

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cocoindex 1.0.23
File	Size	Uploaded
cocoindex-1.0.23.tar.gz	775.3 kB	Sep 13, 2026	Details

Built distributions (wheels)

Table of built distributions (wheels) for cocoindex 1.0.23
File	Interpreter	ABI	Platform	Reset
cocoindex-1.0.23-cp314-cp314t-win_amd64.whl 9.9 MB Sep 13, 2026	CPython 3.14	CPython 3.14 free-threading	Windows x86-64	Details
cocoindex-1.0.23-cp314-cp314t-manylinux_2_28_x86_64.whl 9.7 MB Sep 13, 2026	CPython 3.14	CPython 3.14 free-threading	Linux glibc 2.28+ x86-64	Details
cocoindex-1.0.23-cp314-cp314t-manylinux_2_28_aarch64.whl 9.5 MB Sep 13, 2026	CPython 3.14	CPython 3.14 free-threading	Linux glibc 2.28+ ARM64	Details
cocoindex-1.0.23-cp314-cp314t-macosx_11_0_arm64.whl 9.6 MB Sep 13, 2026	CPython 3.14	CPython 3.14 free-threading	macOS 11.0+ ARM64	Details
cocoindex-1.0.23-cp311-abi3-win_amd64.whl 10.0 MB Sep 13, 2026	CPython 3.11	abi3	Windows x86-64	Details
cocoindex-1.0.23-cp311-abi3-manylinux_2_28_x86_64.whl 9.7 MB Sep 13, 2026	CPython 3.11	abi3	Linux glibc 2.28+ x86-64	Details
cocoindex-1.0.23-cp311-abi3-manylinux_2_28_aarch64.whl 9.5 MB Sep 13, 2026	CPython 3.11	abi3	Linux glibc 2.28+ ARM64	Details
cocoindex-1.0.23-cp311-abi3-macosx_11_0_arm64.whl 9.6 MB Sep 13, 2026	CPython 3.11	abi3	macOS 11.0+ ARM64	Details
cocoindex-1.0.23-cp311-abi3-macosx_10_12_x86_64.whl 9.5 MB Sep 13, 2026	CPython 3.11	abi3	macOS 10.12+ x86-64	Details

Total release size: 87.8 MB

Release files / cocoindex-1.0.23.tar.gz

Download URL	cocoindex-1.0.23.tar.gz
Size	775.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`c7feaa2243c095a81c729fcb4a4c71b18e9c8cd95081be678983b503c13b033d`
BLAKE2b-256 checksum How to use checksums	`c8a1bf8b3de3f3c8d639dfd4db72c834716fb5707b81dad7d7d661a72258c149`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`maturin/1.15.0`

Release files / cocoindex-1.0.23-cp314-cp314t-win_amd64.whl

Download URL	cocoindex-1.0.23-cp314-cp314t-win_amd64.whl
Size	9.9 MB
Tags	CPython 3.14 CPython 3.14 free-threading Windows x86-64
SHA-256 checksum How to use checksums	`0b8642383da3fbfa0de25690546e72b000d5bfde1454b931e6beff74a4dc64a3`
BLAKE2b-256 checksum How to use checksums	`34e66c25f277edd2d1c6bba64c6781f7caa249efa97d39411baaae08aa98ee1f`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`maturin/1.15.0`

Release files / cocoindex-1.0.23-cp314-cp314t-manylinux_2_28_x86_64.whl

Download URL	cocoindex-1.0.23-cp314-cp314t-manylinux_2_28_x86_64.whl
Size	9.7 MB
Tags	CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ x86-64
SHA-256 checksum How to use checksums	`f7eb0889633a680aa9190185bd3cee061cb1e1ffc0c63cc73fab3f12ec87c1a5`
BLAKE2b-256 checksum How to use checksums	`4cea7e6f8bc93ed90383ed676e9ef89f89b83eb2cc2cd0eb9e7e79876de578b5`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`maturin/1.15.0`

Release files / cocoindex-1.0.23-cp314-cp314t-manylinux_2_28_aarch64.whl

Download URL	cocoindex-1.0.23-cp314-cp314t-manylinux_2_28_aarch64.whl
Size	9.5 MB
Tags	CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ ARM64
SHA-256 checksum How to use checksums	`9b3996a5180d5536307e4930c3d6c548262e02e4b6b1b81ebe83e6939f36da8c`
BLAKE2b-256 checksum How to use checksums	`858193a7552cd2dfcf19982dc5c7517853f8618be4a6ef5b8d0606f2ae407955`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`maturin/1.15.0`

Release files / cocoindex-1.0.23-cp314-cp314t-macosx_11_0_arm64.whl

Download URL	cocoindex-1.0.23-cp314-cp314t-macosx_11_0_arm64.whl
Size	9.6 MB
Tags	CPython 3.14 CPython 3.14 free-threading macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`96101f660fe7be3d2fcc2cdf509f03f31994ad7d11cc5fd59fec465673cd119b`
BLAKE2b-256 checksum How to use checksums	`d97111872c8bcc5c2470861da18a7738e23c0016541e4cb616664022e67fac45`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`maturin/1.15.0`

Release files / cocoindex-1.0.23-cp311-abi3-win_amd64.whl

Download URL	cocoindex-1.0.23-cp311-abi3-win_amd64.whl
Size	10.0 MB
Tags	CPython 3.11 Windows x86-64 abi3
SHA-256 checksum How to use checksums	`84a9654845be62e15519d3292c45ffde00a876a18db5ca788dbea7bac722a893`
BLAKE2b-256 checksum How to use checksums	`46cb86303e3f95bea15bcb04aa2cada5caa352a6ad9f58bb0835ba91db574eda`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`maturin/1.15.0`

Release files / cocoindex-1.0.23-cp311-abi3-manylinux_2_28_x86_64.whl

Download URL	cocoindex-1.0.23-cp311-abi3-manylinux_2_28_x86_64.whl
Size	9.7 MB
Tags	CPython 3.11 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum How to use checksums	`3161566b63478fea7f51390a0039badb171f75a553492ae86a42399dd30d5ba5`
BLAKE2b-256 checksum How to use checksums	`c23789b65e5c58f479951abbaf3d0b88f8384a2e5e13050748176c9a447eefe0`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`maturin/1.15.0`

Release files / cocoindex-1.0.23-cp311-abi3-manylinux_2_28_aarch64.whl

Download URL	cocoindex-1.0.23-cp311-abi3-manylinux_2_28_aarch64.whl
Size	9.5 MB
Tags	CPython 3.11 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum How to use checksums	`7f47d1118965fc80af9c672293c5d75810e26c19eb91300e9f78b45846fcfdae`
BLAKE2b-256 checksum How to use checksums	`b28a511cabe4a0684fc5f9cfcaab967a7a454e8522cb9f3104a092b3037bacd4`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`maturin/1.15.0`

Release files / cocoindex-1.0.23-cp311-abi3-macosx_11_0_arm64.whl

Download URL	cocoindex-1.0.23-cp311-abi3-macosx_11_0_arm64.whl
Size	9.6 MB
Tags	CPython 3.11 abi3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`42656d08dbac1a0b2072daa84d8f54abe29e266d0723467e0cc10f8d53e1b065`
BLAKE2b-256 checksum How to use checksums	`1ff97c75c6b6e131da59f48036c835bd7a892201a895f339e841bebb601e4f39`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`maturin/1.15.0`

Release files / cocoindex-1.0.23-cp311-abi3-macosx_10_12_x86_64.whl

Download URL	cocoindex-1.0.23-cp311-abi3-macosx_10_12_x86_64.whl
Size	9.5 MB
Tags	CPython 3.11 abi3 macOS 10.12+ x86-64
SHA-256 checksum How to use checksums	`bb706a381d829c8dd8ce0959d452d944f1af12abbe2db10a28f7c8255723a898`
BLAKE2b-256 checksum How to use checksums	`2947821a207d9d6b9dbf8d638d37e596b790cb33fb4cf1a61c41dc519f83e3bd`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`maturin/1.15.0`