Metadata-Version: 2.4
Name: meshdb-go
Version: 2.0.1
Summary: Local full-text + vector search with retrieval-first philosophy
Author-email: zeus <zeus@zeus.kim>
License: MIT
Project-URL: Homepage, https://github.com/zeus-kim/meshdb
Project-URL: Documentation, https://github.com/zeus-kim/meshdb/blob/main/docs/QUICKSTART.md
Project-URL: Repository, https://github.com/zeus-kim/meshdb
Project-URL: Issues, https://github.com/zeus-kim/meshdb/issues
Keywords: search,rag,vector,embedding,local,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Database
Classifier: Topic :: Text Processing :: Indexing
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# MeshDB

Local full-text + vector search with retrieval-first philosophy.

## Installation

```bash
pip install meshdb-go
```

## Quick Start

```bash
# Check status
meshdb status

# Index your files
meshdb index ~/Documents

# Search
meshdb search "meeting notes"

# Semantic search (requires Ollama)
meshdb semantic "how does authentication work"
```

## Features

- **Full-text search** (FTS5) with multilingual support
- **Semantic search** using Ollama embeddings (bge-m3)
- **Hybrid search** combining keyword + vector similarity
- **MCP integration** for Claude Desktop
- **100% local** - no data leaves your machine
- **Sensitive data blocking** at indexing time

## Requirements

- macOS or Linux
- Python 3.9+
- Ollama (optional, for semantic search)

## Ollama Setup (Optional)

For semantic search capabilities:

```bash
# Install Ollama
brew install ollama  # macOS
# or: curl -fsSL https://ollama.com/install.sh | sh  # Linux

# Start Ollama
ollama serve

# Pull embedding model
ollama pull bge-m3
```

## Claude Desktop Integration

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "meshdb": {
      "command": "meshdb",
      "args": ["mcp"]
    }
  }
}
```

## Documentation

- [Quick Start](https://github.com/zeus-kim/meshdb/blob/main/docs/QUICKSTART.md)
- [Installation Guide](https://github.com/zeus-kim/meshdb/blob/main/docs/INSTALL.md)
- [MCP Integration](https://github.com/zeus-kim/meshdb/blob/main/docs/MCP_INTEGRATION.md)

## License

MIT
