# AiFastDb Python SDK

High-performance AI-friendly database engine — Python bindings.

## Overview

AiFastDb provides a unified Python interface to multiple storage engines:

| Module | Description |
|--------|-------------|
| **AiFastDb** | Core key-value store with HNSW vector search |
| **SocialGraphV2** | Social network graph with path finding & analysis |
| **DocumentStore** | JSONL document store with tag/type indexing |
| **Federation** | Multi-store federation with cross-DB queries |
| **EmbeddingEngine** | Built-in vector embedding generation |
| **ReasoningEngine** | LLM-based reasoning (Ollama/OpenAI) |
| **PerceptionPipeline** | Combined embedding + reasoning |

## Installation

```bash
pip install aifastdb
```

## Quick Example

```python
from aifastdb import AiFastDb, EmbeddingEngine

# Store and search
with AiFastDb("./my_db") as db:
    db.remember("doc1", "Hello world", tags=["greeting"])
    results = db.recall(query="hello")

# Generate embeddings
engine = EmbeddingEngine()
vec = engine.embed("Hello world")
print(f"Dimension: {len(vec)}")
```

## Supported Python Versions

- Python 3.8, 3.9, 3.10, 3.11, 3.12
- Platforms: Linux (x86_64, aarch64), macOS (Intel, Apple Silicon), Windows (x86_64)
