Metadata-Version: 2.4
Name: flowdb
Version: 0.1.3
Summary: The AI-Native Database: JSON + Vectors + MCP
Project-URL: Homepage, https://github.com/yourusername/flowdb
Project-URL: Issues, https://github.com/yourusername/flowdb/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.10
Requires-Dist: fastapi>=0.100.0
Requires-Dist: fastmcp
Requires-Dist: lmdb>=1.4.0
Requires-Dist: numpy
Requires-Dist: openai
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv
Requires-Dist: requests
Requires-Dist: usearch>=2.9.0
Requires-Dist: uvicorn[standard]>=0.20.0
Description-Content-Type: text/markdown

# FlowDB

FlowDB 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

FlowDB 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.

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

-----

## Getting Started

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

### [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 FlowDB 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.

-----
