OreoLook
**A curious, open-source AI search scout with real-time web research, RAG, and an OpenAI-compatible API.**
[](https://huggingface.co/spaces/Elixpo/OreoLook)
[](https://huggingface.co/datasets/p-research/oreolook-research-evals)
[](https://arxiv.org/abs/2609.05463)
[](https://huggingface.co/collections/p-research/oreolook-ai-search-with-receipts-6aac116611ba981a1b8f31fe)
[](https://pollinations.ai)
[](https://opensource.org/licenses/MIT) [](https://www.python.org/) [](https://www.docker.com/) [](#-api-usage) [](https://redis.io/) [](https://playwright.dev/) [](https://pages.cloudflare.com/) [](https://github.com/pollinations/search.elixpo/stargazers) [](https://github.com/pollinations/search.elixpo/network/members) [](https://github.com/pollinations/search.elixpo/issues) [](https://github.com/pollinations/search.elixpo/commits/main)
---
## 🎁 Core Capabilities
| Capability | Implementation |
|-----------|---------------|
| **Real-time streaming** | Server-Sent Events (SSE) — tokens stream as they're generated, not buffered |
| **Semantic caching** | Redis DB0 with cosine similarity (threshold 0.90) — repeat queries resolve in <15ms |
| **Multi-turn memory** | Two-tier hybrid: Redis hot window (20 msgs) + Huffman-compressed disk archive (30-day TTL) |
| **Dynamic context** | Token-budget based history injection (6000 tokens) — model gets as much context as it needs |
| **Source attribution** | Every claim links to the original URL, with full-text extraction and relevance scoring |
| **Deep search mode** | Decomposes complex queries into sub-queries, runs parallel mini-pipelines, synthesizes a unified answer |
---
## 📖 API Usage
OreoLook is available through [Pollinations.ai](https://pollinations.ai) and can also be self-hosted.
OreoLook exposes an **OpenAI-compatible** API. Keep using `lixsearch` as the model ID for direct and Pollinations-routed requests.
### Use through Pollinations
```bash
curl https://gen.pollinations.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $POLLINATIONS_API_KEY" \
-d '{
"model": "lixsearch",
"messages": [{"role": "user", "content": "What changed in AI today?"}],
"stream": true
}'
```
### Basic search
```bash
curl -X POST https://search.elixpo.com/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"messages": [{"role": "user", "content": "What is the best way to learn Python?"}],
"stream": true
}'
```
### Multi-turn conversation
```bash
curl -X POST https://search.elixpo.com/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"messages": [
{"role": "user", "content": "What is the best way to learn Python?"},
{"role": "assistant", "content": "Here are the top approaches..."},
{"role": "user", "content": "What about free resources specifically?"}
],
"stream": true
}'
```
The full conversation history is injected into the model context — no session ID management needed.
### Non-streaming (JSON response)
```bash
curl -X POST https://search.elixpo.com/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"messages": [{"role": "user", "content": "Latest breakthroughs in AI"}],
"stream": false
}'
```
Returns a standard `chat.completion` object with `usage` (prompt/completion tokens) and `choices[0].message.content`.
### Available endpoints
| Endpoint | Method | Description |
|----------|--------|-------------|
| `/v1/chat/completions` | POST | OpenAI-compatible chat completions (stream + non-stream) |
| `/v1/models` | GET | List available models |
| `/api/search` | POST/GET | Legacy search endpoint (SSE) |
| `/api/stats` | GET | Redis memory, disk archive stats, session counts |
| `/api/health` | GET | Health check |
| `/mcp` | POST/GET/DELETE | Stateless Streamable HTTP MCP: research, deep research, PDF export |
| `/docs` | GET | Interactive API documentation (Scalar UI) |
MCP setup, authentication, tools, and limits are documented in [docs/MCP.md](docs/MCP.md).
Pollinations `endpoint_agent` registration, delegated `ag_` authentication,
and the local/static-key split are documented in
[docs/AGENT_RUN_TOKENS.md](docs/AGENT_RUN_TOKENS.md).
---
---
## Request Flow
> This is the flow of the request that we have from the CF Reverse proxy
```
Browser → search.elixpo.com (Cloudflare Pages, edge)
↓
Next.js API route (e.g. /api/search/route.ts)
↓
backendUrl("/api/search") → "http://search.elixpo.com/api/search"
↓
fetch() with headers:
X-API-Key: