Metadata-Version: 2.4
Name: courierdb
Version: 0.2.4
Summary: The AI-Native Database: JSON + Vectors + MCP
Project-URL: Homepage, https://github.com/yourusername/courierdb
Project-URL: Issues, https://github.com/yourusername/courierdb/issues
Author-email: Your Name <your.email@example.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agent,ai,database,mcp,rag,vector
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Requires-Dist: fastapi==0.124.0
Requires-Dist: fastmcp==2.13.3
Requires-Dist: lmdb==1.7.5
Requires-Dist: numpy==2.2.6
Requires-Dist: pydantic==2.12.5
Requires-Dist: python-dotenv==1.2.1
Requires-Dist: requests==2.32.5
Requires-Dist: usearch==2.21.0
Requires-Dist: uvicorn[standard]==0.41.0
Provides-Extra: openai
Requires-Dist: openai==2.9.0; extra == 'openai'
Description-Content-Type: text/markdown

# CourierDB

CourierDB is a JSON-based database stack that is AI-Native.

It's core objective is to be fast, simple, and n8n + AI optimized.

-----

## Core Features

- JSON (No-SQL)
- API controlled for n8n-usage and database safety
- API Key protected
- Dockerized for ease of use
- MCP server for Agentic use
- Vectorization built in (BYOK)
- Client CLI and PyPi package
- Speed: Built on LMDB (Lightning Memory-Mapped Database) and USearch (HNSW Vector Search).

-----

## Guidelines

CourierDB is intentionally built to be fast, simple, and AI-Native. It is **NOT** ideal for compliance applications such as
FinTech because it lacks SQLs ACID safety measures.

CourierDB is ideal for AI applications, automation, speed, and n8n workflows.

-----

## Getting Started

### GitHub: https://github.com/RecursionAI/CourierDB

### [Install and Setup](./docs/install.md)

Full guide to install both the Client SDK and configure the dockerized server.

### [Client SDK](./docs/sdk.md)

How to use the client SDK to interact with the database in your code and utilyze Pydantic models

### [Full n8n Guide](./docs/n8n.md)

Comprehensive guide for implementing CourierDB in your n8n workflows for and open-source persistent memory adn VectorDB
solution.

### [URL Schemas](./docs/schemas.md)

URL schemas and API guidelines.


### [MCP Server](./docs/mcp.md)
How the MCP server works and how to set it up so Claude Desktop can use it and interact with your db.

-----
