Metadata-Version: 2.3
Name: humandb
Version: 0.1.0
Summary: The world's first human-powered analytical database.
Author: mehd-io
Author-email: mehd-io <mehdi@mehd.io>
Requires-Python: >=3.10
Project-URL: Homepage, https://humandb.motherduck.com
Description-Content-Type: text/markdown

<p align="center">
  <img src="assets/logo.svg" alt="HumanDB" width="64" height="64">
</p>

<h1 align="center">HumanDB</h1>

The world's first human-powered analytical database.

## Quick Start

```bash
pip install humandb
```

```python
import humandb

humandb.query("SELECT COUNT(*) FROM orders")
# 🔄 Dave is squinting at this...
# 📞 Contacting Dave for this query... waiting for his reply
# 🔊 dave_answer_a1b2c3d4.mp3 received
# "Okay so I went through the orders table, there's like 1.8 million rows.
#  One of them is from 1987 which seems wrong but I didn't want to bring it up."
```

## Features

- **In-brain columnar storage** — data lives in Dave's hippocampus. No disk I/O. Occasional déjà vu.
- **Post-it indexing** — sub-optimal but colorful.
- **OLAH processing** — OnLine Analytical Humans. Industry-standard since 2003.
- **Eventual consistency** — Dave will get back to you. He's about 80% sure.
- **Sub-hour query latency** — or 3 days if it's quarter-end.
- **Emotional consistency guarantees** — Dave is always mildly exhausted.

## Requirements

- Python 3.10+
- Speaker/headphones (recommended — Dave has a voice)
- Patience

## How It Works

`humandb.query()` sends your SQL to Dave (a tired senior data analyst), who processes it by hand using spreadsheets, Post-its, and gut instinct. Results are returned verbally as an MP3 and printed to your console.

Dave's accuracy is approximately 80%. He's doing his best.

---

Built with ❤️ and mild existential dread by [MotherDuck](https://motherduck.com).

*Happy April Fools. Try the real thing → [motherduck.com](https://motherduck.com)*
