---
title: Context Store
emoji: 🧠
colorFrom: blue
colorTo: purple
sdk: docker
app_file: Dockerfile
pinned: false
license: mit
---

# Context Store - Intelligent Memory Layer

A powerful unified memory layer for AI tools and applications. Context Store provides intelligent knowledge management, real-time data ingestion, and seamless AI integration capabilities.

## 🚀 Features

- **🧠 Unified Memory Layer** - Centralized knowledge storage and retrieval
- **🕸️ Knowledge Graph** - Neo4j-powered relationship mapping  
- **⚡ Background Processing** - Trigger.dev v4 integration
- **🤖 MCP Integration** - Model Context Protocol for AI tools
- **📡 Real-time Ingestion** - Live data streaming via webhooks
- **🔒 Secure Authentication** - OAuth2 and session management

## 🔧 Setup

Configure these environment variables in your Space settings:

```env
DATABASE_URL=postgresql://username:password@hostname:port/database
DIRECT_URL=postgresql://username:password@hostname:port/database
NEO4J_URI=neo4j+s://your-instance.databases.neo4j.io
NEO4J_USERNAME=neo4j
NEO4J_PASSWORD=your_password
REDIS_HOST=your-redis.upstash.io
REDIS_PORT=6379
REDIS_PASSWORD=your_password
OPENAI_API_KEY=sk-your-key
TRIGGER_PROJECT_ID=proj_gtuachiolvvekkzclssn
TRIGGER_SECRET_KEY=tr_dev_your_key
SESSION_SECRET=your-32-char-secret
ENCRYPTION_KEY=your-32-char-key
```

### Free External Services
- **Neon PostgreSQL**: 500MB free
- **Neo4j Aura**: 200k nodes free  
- **Upstash Redis**: 10k commands/day free

## 📚 API Usage

### Add Memory
```bash
POST /api/v1/add
{
  "episodeBody": "Your memory content",
  "source": "api"
}
```

### Search Memory  
```bash
GET /api/v1/search?q=your+query
```

### MCP Server
```bash
# Connect from any device with Claude Code
claude mcp add context-store https://your-username-context-store.hf.space
```

## 🔗 Links

- [GitHub Repository](https://github.com/BTankut/Context-Store)  
- [Setup Guide](https://github.com/BTankut/Context-Store/blob/main/external-services-setup.md)
- [MCP Integration](https://github.com/BTankut/Context-Store/blob/main/mcp-server-setup.md)

---

**Context Store** - Universal AI Memory, No Local Setup Required# HuggingFace deployment fix