inspiration-app/README.md
2025-10-04 09:13:41 -06:00

140 lines
4.1 KiB
Markdown

<div align="center">
# ✨ Inspiration Engine
**Your private creative memory. Search by idea, not filename.**
[![Status](https://img.shields.io/badge/status-active-success.svg)]()
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)]()
**[Chat with this repository](https://n8n.biohazardvfx.com/webhook/027eb8bf-1217-4bbb-8189-6ec99023a53a/chat)**
---
</div>
## What is This?
A unified, encrypted library for images, videos, links, and notes that you can actually *find* again. No more scattered Pinterest boards, lost TikToks, or forgotten bookmarks. Just one searchable creative memory that understands what's *in* your content, not just its filename.
```
"burnt orange hoodie in strong rim light" → finds it instantly
No tags. No folders. Just search by what you remember.
```
## Core Principles
<table>
<tr>
<td width="25%" align="center"><b> Private by Design</b><br/>E2EE encryption. Zero server visibility.</td>
<td width="25%" align="center"><b> Multimodal Search</b><br/>OCR + vision embeddings across all media.</td>
<td width="25%" align="center"><b> Native Ingest</b><br/>Automated capture from social platforms.</td>
<td width="25%" align="center"><b> Own Your Data</b><br/>BYO storage. Open standards. Full exports.</td>
</tr>
</table>
## The Differentiators
Unlike **Raindrop.io** (no E2EE, limited storage), **Pinterest** (public-first), **mymind** (closed ecosystem), or **Eagle** (local-only):
- **Search semantically** → "sunset over water" finds it even if you named it `IMG_2847.jpg`
- **Encrypted end-to-end** → Only you can decrypt your content
- **Auto-ingest from Instagram, TikTok, X** → Stop manually saving everything
- **Bring your own S3/Nextcloud** → No arbitrary storage caps
- **Open standards (OCMS/CRQL)** → Export anytime, integrate anywhere
## Architecture
```
┌─────────────┐
│ Client │ ← E2EE, Local OCR, Vision Embeddings
└──────┬──────┘
│ encrypted
┌──────▼──────┐
│ Cloudflare │ ← Metadata only, Workers, D1, R2
│ Platform │
└──────┬──────┘
┌──────▼──────┐
│ Qdrant │ ← Vector search (encrypted)
└─────────────┘
```
**Stack**: Next.js • Cloudflare Workers • D1 • R2 • Qdrant • ONNX
## Documentation
<details>
<summary><b> Project Brief</b> - Product vision & MVP scope</summary>
→ See `Project-Brief.md` for target users, success metrics, and technical requirements.
</details>
<details>
<summary><b> Competitive Analysis</b> - Market positioning</summary>
→ See `Competitive-Analysis-Report.md` for how we stack up against Raindrop, Pinterest, et al.
</details>
<details>
<summary><b> Open Source Strategy</b> - OCMS & CRQL specs</summary>
→ See `Ideation-Session-02.md` for our plan to become the interoperability layer for creative memory.
</details>
<details>
<summary><b> Brainstorming Results</b> - How we got here</summary>
→ See `Brainstorm-Session-Results.md` for the ideation process.
</details>
## MVP Goals
| Metric | Target | Why |
|--------|--------|-----|
| Week 1 Retention | ≥60% | Prove core value |
| Search Response | ≤300ms | Instant feel |
| Items Saved/Week | ≥10 | Measure capture depth |
| Search Usage | ≥75% weekly | Validate semantic search |
## Quick Start
```bash
# Clone
git clone https://git.biohazardvfx.com/Nicholai/inspiration-app.git
# Install
pnpm install
# Run locally
pnpm dev
# Deploy to Cloudflare
pnpm deploy
```
## Roadmap
- [x] Core architecture & specs
- [x] Competitive analysis
- [ ] MVP: Instagram connector + semantic search
- [ ] Mobile apps (iOS/Android)
- [ ] Additional social connectors
- [ ] BYO storage adapters
- [ ] Developer API
- [ ] Teams & collaboration
## License
Code: **Apache 2.0** • Specs: **CC BY**
---
<div align="center">
**Built for creators who are tired of losing their inspiration**
*Questions? [Chat with this repo](https://n8n.biohazardvfx.com/webhook/027eb8bf-1217-4bbb-8189-6ec99023a53a/chat)*
</div>