Metadata-Version: 2.4
Name: memesdb
Version: 0.1.1
Summary: index and search your meme stash with ai
Project-URL: Homepage, https://github.com/yourusername/memesdb
Project-URL: Bug Tracker, https://github.com/yourusername/memesdb/issues
Author-email: baketnk <baketnk@protonmail.com>
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: einops
Requires-Dist: fzf-py
Requires-Dist: imagehash
Requires-Dist: moondream
Requires-Dist: pillow
Requires-Dist: pyvips
Requires-Dist: rich
Requires-Dist: sentence-transformers
Requires-Dist: sqlite-vec
Requires-Dist: typer
Description-Content-Type: text/markdown

# MemesDB 🗄️✨

index and search your meme stash with ai

## install
```bash
pip install memesdb
```

or use `uv tool`

`uv tool install memesdb`

## usage
```bash
# index a directory of memes
memesdb index ~/Downloads/memes

# search your collection
memesdb search "cat wearing sunglasses"

# add custom tags (more coming soon)
memesdb tag

# check DB stats
memesdb stats
```

## features
- 🤖 ai-powered image captioning and tagging
- 🔍 semantic search with vector embeddings
- 📁 sqlite storage for portability
- ⚡ fuzzy finder interface

## license

MIT

## thanks

- vikhyatk for making moondream https://x.com/vikhyatk
- the entire ecosystem for making AI stuff free for the common dev like me
