privatedeepsearch-melt

"Google wants to know everything about you. I want to know nothing." — melt, probably

melt is your privacy-obsessed research assistant. She searches the web deeply, synthesizes findings with citations, and forgets everything the moment she's done.

Powered by SearXNG. No Google. No tracking. No API keys. No BS.

---

What melt Does

🔍 She Searches (Privately)

searx "best password managers 2026" 5

melt queries DuckDuckGo, Brave, Startpage, and friends. Google and Bing are blocked at the door.

🔬 She Researches (Deeply)

deep-research "zero knowledge proofs practical applications"

melt doesn't just search once and call it a day. She:

1. Searches your query
2. Reads the results
3. Thinks "hmm, I need more context"
4. Searches again with refined terms
5. Scrapes full article content
6. Repeats up to 5 times
7. Synthesizes everything into a report with citations

Like Perplexity, but she doesn't sell your soul to investors.

🛡️ She Protects (Always)

What Big Tech Does	What melt Does
Logs every search	Logs nothing
Builds a profile on you	Forgets you exist
Sells your data	Has no data to sell
Runs on their servers	Runs on YOUR machine
Costs $20/month	Costs $0/forever

---

Quick Start

1. Wake melt Up

# Auto-setup (generates secret key + starts container)
./setup.sh

# Or manually
cd docker && docker-compose up -d

She'll be ready at http://localhost:8888

2. Teach Her to Your AI

cp -r skills/* ~/.clawdbot/skills/

# Or via ClawdHub
clawdhub install privatedeepsearch-melt

3. (Optional) Fire the Competition

Tell Clawdbot to stop using Brave API:

{
  "tools": {
    "web": {
      "search": { "enabled": false }
    }
  }
}

---

How Deep Research Actually Works

You: "explain quantum computing"
                    │
                    ▼
    ┌───────────────────────────────┐
    │  melt: "Got it. Let me dig."  │
    └───────────────┬───────────────┘
                    │
    Round 1: "explain quantum computing"
    Round 2: "quantum computing detailed analysis"
    Round 3: "quantum computing comprehensive guide"
                    │
                    ▼
    ┌───────────────────────────────┐
    │  SearXNG: *queries 5 engines* │
    │  Returns 10 results per round │
    └───────────────┬───────────────┘
                    │
                    ▼
    ┌───────────────────────────────┐
    │  melt: "YouTube? Facebook?    │
    │         Nice try. BLOCKED."   │
    └───────────────┬───────────────┘
                    │
                    ▼
    ┌───────────────────────────────┐
    │  *Scrapes 10 pages at once*   │
    │  asyncio go brrrrrr           │
    └───────────────┬───────────────┘
                    │
                    ▼
    ┌───────────────────────────────┐
    │  # Deep Research Report       │
    │  **Sources:** 17              │
    │  ## [1] Quantum 101...        │
    │  ## [2] IBM's Breakthrough... │
    └───────────────────────────────┘

---

Privacy Architecture

Your brain
    │
    ▼ (you type a query)
┌─────────────────┐
│   Clawdbot      │  ← Your machine. Your rules.
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│     melt        │  ← Localhost. No cloud. No logs.
│   (SearXNG)     │
└────────┬────────┘
         │
         ▼ (optional but recommended)
┌─────────────────┐
│    Your VPN     │  ← Hide your IP from everyone
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  DuckDuckGo     │  ← They see VPN IP, not you
│  Brave Search   │
│  Startpage      │
└─────────────────┘

Who sees what:

• Google: Nothing. Blocked.
• Your ISP: Encrypted traffic. They mad.
• melt: Everything. But she has amnesia.

---

Why Open Source Matters

melt is MIT licensed because:

1. You can audit the code — No hidden trackers
2. You can fork it — Make your own version
3. You can improve it — PRs welcome
4. You own your data — It never leaves your machine

Closed-source "privacy" tools ask you to trust them. melt asks you to verify.

---

Engines melt Trusts

✅ Enabled:

• DuckDuckGo, Brave Search, Startpage
• Qwant, Mojeek
• Wikipedia, GitHub, StackOverflow, Reddit, arXiv
• Piped, Invidious (YouTube without YouTube)

❌ Blocked:

• Google (all of it)
• Bing (all of it)
• Anything that tracks you

---

Requirements

• Docker & Docker Compose
• Python 3.8+
• A healthy distrust of Big Tech

pip install aiohttp beautifulsoup4

---

Files

privatedeepsearch-melt/
├── README.md              ← You are here
├── docker/
│   ├── docker-compose.yml ← SearXNG deployment
│   └── searxng/settings.yml
├── skills/
│   ├── searxng/           ← Basic search skill
│   └── deep-research/     ← The good stuff
└── docs/
    ├── PRIVACY.md         ← How melt protects you
    └── TROUBLESHOOTING.md ← When things break

---

Credits

• SearXNG — The real hero. Privacy-respecting meta-search that makes this possible.
• OpenWebUI Deep Research — Algorithm inspiration
• Clawdbot — AI assistant framework

---

License

MIT — Do whatever you want. Just don't be evil.

---

"The best search history is no search history." — melt

SearXNG 🛡️