Skip to content

Repository files navigation

TideRAG

CF-native RAG Pipeline — $0/mo
Vectorize + Workers AI + D1 at the edge. Zero infrastructure to manage.

Quick Start · How It Works · Why TideRAG? · Ecosystem

npmLicenseTypeScriptCF Workers$0/moPRs


What Is TideRAG?

Most RAG pipelines force you to spin up a vector database (Pinecone, Weaviate, pgvector), manage embedding infrastructure, and pay per-query costs before you have users. TideRAG runs entirely on Cloudflare's free tier — your vector store, embedding inference, and metadata storage all live at the edge.

import{TideRAG}from'@carloscortezcloud/tiderag';constrag=newTideRAG({vectorize: env.VECTORIZE_INDEX,d1: env.DB,ai: env.AI,});// Index a documentawaitrag.ingest({id: 'doc-1',content: 'Cloudflare Workers run on V8 isolates...',metadata: {source: 'docs',category: 'compute'},});// Queryconstresults=awaitrag.query('How do Workers work?',{topK: 3});

Install

npm install @carloscortezcloud/tiderag

Quick Start

1. Install

npm install @carloscortezcloud/tiderag

2. Configure wrangler

# wrangler.jsonc{"vectorize": [{ "binding": "VECTORIZE_INDEX", "index_name": "tiderag" }],"d1_databases": [{ "binding": "DB", "database_name": "tiderag", "database_id": "..." }],"ai": { "binding": "AI" }}

3. Ingest & query

import{TideRAG}from'@carloscortezcloud/tiderag';constrag=newTideRAG({vectorize: env.VECTORIZE_INDEX,d1: env.DB,ai: env.AI});awaitrag.ingest({id: 'doc-1',content: 'Your document text here...',metadata: {source: 'docs'}});constresults=awaitrag.query('Your question',{topK: 3});

How It Works

User Query
│
▼
┌──────────────────┐
│ Workers AI │ ← Embed query via @cf/baai/bge-small-en-v1.5 (free)
│ (embedding) │
└──────┬───────────┘
│ vector
▼
┌──────────────────┐
│ Vectorize │ ← 10M vector index (free tier)
│ (similarity) │
└──────┬───────────┘
│ top-K IDs
▼
┌──────────────────┐
│ D1 │ ← Metadata + chunk storage (5GB free)
│ (metadata) │
└──────┬───────────┘
│ enriched chunks
▼
┌──────────────────┐
│ LLM Response │ ← Augment prompt, return answer
└──────────────────┘

Why TideRAG?

FeatureTideRAGManaged RAG (Pinecone, etc.)
Cost$0/mo (free tier)$70–$700+/mo
Latency<50ms (edge)100–500ms (regional)
InfraZeroVector DB + embedding API
ScalingAuto (Cloudflare)Manual
Data localityEdge (175+ cities)Regional

Deployment

npx wrangler deploy

Ecosystem

PackageRolenpm
TideRAGEdge RAG (this)@carloscortezcloud/tiderag
TinkuyAgent framework@carloscortezcloud/tinkuy-agent
StyrrLLM routerstyrr
SayayCost guardrailsGitHub
QhawayAgent observability@carloscortezcloud/qhaway

License

Apache 2.0 — see LICENSE.


Built by engineers who got tired of $700 vector DB bills.
Tinkuy Labs · finoptix.dev

Your RAG pipeline costs $0/mo. Your AI agent should too.

About

CF-native RAG pipeline ($0/mo). Vectorize + Workers AI + D1. Edge-first retrieval, zero infrastructure.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages