mindreaderv2
Mindreaderv2 is an AI agent platform built on GitHub. It provides a personal knowledge graph for AI agents, offering visual memory that can be seen, managed, and evolved. The system combines Neo4j, Graphiti, and React to create this functionality. It allows users to build and interact with a knowledge graph for their AI agents, facilitating memory management and evolution. This tool is useful for developers working with AI agents and needing a structured way to manage their knowledge.
Mindreaderv2 solves the problem of managing and visualizing AI agent memory, which can be complex and difficult to track manually. It allows developers to easily see, manage, and evolve their agent's knowledge graph instead of relying on unstructured data or manual tracking.
CAPABILITIES & CONSTRAINTS
README
# MindReader Cloud
Multi-tenant cloud version of [MindReader V2](https://github.com/flu012/mindreaderv2) -- personal knowledge graph as a service.
## Quick Start
### Prerequisites
- Docker + Docker Compose
- An LLM API key (OpenAI, DashScope, Anthropic, or Ollama)
- Clone the open-source MindReader V2 repo alongside this one
### Setup
```bash
# Clone both repos
git clone https://github.com/flu012/mindreaderv2.git
git clone https://github.com/flu012/mindreader-cloud.git
cd mindreader-cloud
# Configure LLM
cp .env.example .env
# Edit .env with your LLM API key
# Start all services
docker compose up -d
```
The API will be available at `http://localhost:5000`.
### Register & Use
```bash
# Register
curl -X POST http://localhost:5000/api/v1/auth/register \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com","password":"YourPass123!","name":"Your Name"}'
# Login
curl -X POST http://localhost:5000/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com","password":"YourPass123!"}'
# Use the token to access graph APIs
curl http://localhost:5000/api/v1/graph/graph?limit=100 \
-H "Authorization: Bearer YOUR_TOKEN"
```
## Architecture
```
User -> Cloud API (.NET 8, port 5000)
| proxy with X-Tenant-Id
MindReader Express (internal)
|
Neo4j (knowledge graph)
```
- **.NET API** handles auth, tenants, usage limits
- **MindReader Express** handles graph operations (internal only)
- **Neo4j** stores the knowledge graph
- **SQL Server** stores users, tenants, billing
## Free Tier
- 100 entities
- 500 relationships
- 5 evolves per day
## License
MIT
PUBLIC HISTORY
IDENTITY
Identity inferred from code signals. No PROVENANCE.yml found.
Is this yours? Claim it →METADATA
README BADGE
Add to your README:
