René's URL Explorer Experiment


Title: GitHub - marcelgood/rag-example: A step-by-step RAG learning project in Node.js and TypeScript: document search (vector, hybrid, re-ranking), text-to-SQL, evals, MCP servers, the Vercel AI SDK and LangChain, plus sign-in and multi-tenancy. Runs with a local model (Ollama) or Claude. · GitHub

Open Graph Title: GitHub - marcelgood/rag-example: A step-by-step RAG learning project in Node.js and TypeScript: document search (vector, hybrid, re-ranking), text-to-SQL, evals, MCP servers, the Vercel AI SDK and LangChain, plus sign-in and multi-tenancy. Runs with a local model (Ollama) or Claude.

X Title: GitHub - marcelgood/rag-example: A step-by-step RAG learning project in Node.js and TypeScript: document search (vector, hybrid, re-ranking), text-to-SQL, evals, MCP servers, the Vercel AI SDK and LangChain, plus sign-in and multi-tenancy. Runs with a local model (Ollama) or Claude.

Description: A step-by-step RAG learning project in Node.js and TypeScript: document search (vector, hybrid, re-ranking), text-to-SQL, evals, MCP servers, the Vercel AI SDK and LangChain, plus sign-in and multi-tenancy. Runs with a local model (Ollama) or Claude. - marcelgood/rag-example

Open Graph Description: A step-by-step RAG learning project in Node.js and TypeScript: document search (vector, hybrid, re-ranking), text-to-SQL, evals, MCP servers, the Vercel AI SDK and LangChain, plus sign-in and multi...

X Description: A step-by-step RAG learning project in Node.js and TypeScript: document search (vector, hybrid, re-ranking), text-to-SQL, evals, MCP servers, the Vercel AI SDK and LangChain, plus sign-in and multi...

Mail addresses
anna@larkspur.test

Opengraph URL: https://github.com/marcelgood/rag-example

X: @github

direct link

Domain: github.com

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/:user_id/:repository
route-controllerfiles
route-actiondisambiguate
fetch-noncev2:c197d82d-da25-28a0-359d-1ee3e740ccbc
current-catalog-service-hashf3abb0cc802f3d7b95fc8762b94bdcb13bf39634c40c357301c4aa1d67a256fb
request-id969E:FC5BE:1A6FB0F:230E375:6B0155E2
html-safe-noncee047e67113f2e6098145a9a4927a982adf2ae8e64b928a8a348fcfc6221eb771
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI5NjlFOkZDNUJFOjFBNkZCMEY6MjMwRTM3NTo2QjAxNTVFMiIsInZpc2l0b3JfaWQiOiIzMjczNDIzNjQ1ODYyNjE0NDk4IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmac987983b7f97acd2cefee8541c314bdab02932da9c18f51e5582d240e54b9b2f0
hovercard-subject-tagrepository:1450458788
github-keyboard-shortcutsrepository,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location//
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/marcelgood/rag-example
twitter:imagehttps://opengraph.githubassets.com/110caaca657161fbde5becb5ef347490da97629968cc450802d9f12a65e56d8e/marcelgood/rag-example
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/110caaca657161fbde5becb5ef347490da97629968cc450802d9f12a65e56d8e/marcelgood/rag-example
og:image:altA step-by-step RAG learning project in Node.js and TypeScript: document search (vector, hybrid, re-ranking), text-to-SQL, evals, MCP servers, the Vercel AI SDK and LangChain, plus sign-in and multi...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
Nonecc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c
turbo-cache-controlno-cache
go-importgithub.com/marcelgood/rag-example git https://github.com/marcelgood/rag-example.git
octolytics-dimension-user_id1584834
octolytics-dimension-user_loginmarcelgood
octolytics-dimension-repository_id1450458788
octolytics-dimension-repository_nwomarcelgood/rag-example
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id1450458788
octolytics-dimension-repository_network_root_nwomarcelgood/rag-example
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release8c77c9e8439031ad54c75a250694842892f693e1
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/marcelgood/rag-example#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmarcelgood%2Frag-example
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmarcelgood%2Frag-example
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E&source=header-repo&source_repo=marcelgood%2Frag-example
Reloadhttps://github.com/marcelgood/rag-example
Reloadhttps://github.com/marcelgood/rag-example
Reloadhttps://github.com/marcelgood/rag-example
marcelgoodhttps://github.com/marcelgood
rag-examplehttps://github.com/marcelgood/rag-example
Codehttps://github.com/marcelgood/rag-example
Issueshttps://github.com/marcelgood/rag-example/issues
Pull requestshttps://github.com/marcelgood/rag-example/pulls
Actionshttps://github.com/marcelgood/rag-example/actions
Projectshttps://github.com/marcelgood/rag-example/projects
Security and qualityhttps://github.com/marcelgood/rag-example/security
Insightshttps://github.com/marcelgood/rag-example/pulse
https://github.com/marcelgood/rag-example
rag-examplehttps://github.com/marcelgood/rag-example
Notificationshttps://github.com/login?return_to=%2Fmarcelgood%2Frag-example
Fork0 (0)https://github.com/login?return_to=%2Fmarcelgood%2Frag-example
Star0 (0)https://github.com/login?return_to=%2Fmarcelgood%2Frag-example
anthropichttps://github.com/topics/anthropic
better-authhttps://github.com/topics/better-auth
claudehttps://github.com/topics/claude
embeddingshttps://github.com/topics/embeddings
evalshttps://github.com/topics/evals
hybrid-searchhttps://github.com/topics/hybrid-search
lancedbhttps://github.com/topics/lancedb
langchainhttps://github.com/topics/langchain
llmhttps://github.com/topics/llm
mcphttps://github.com/topics/mcp
model-context-protocolhttps://github.com/topics/model-context-protocol
multi-tenancyhttps://github.com/topics/multi-tenancy
nodejshttps://github.com/topics/nodejs
ollamahttps://github.com/topics/ollama
raghttps://github.com/topics/rag
rerankinghttps://github.com/topics/reranking
retrieval-augmented-generationhttps://github.com/topics/retrieval-augmented-generation
text-to-sqlhttps://github.com/topics/text-to-sql
typescripthttps://github.com/topics/typescript
vercel-ai-sdkhttps://github.com/topics/vercel-ai-sdk
Readmehttps://github.com/marcelgood/rag-example#readme-ov-file
Activityhttps://github.com/marcelgood/rag-example/activity
0 forkshttps://github.com/marcelgood/rag-example/forks
Report repositoryhttps://github.com/contact/report-content?content_url=https%3A%2F%2Fgithub.com%2Fmarcelgood%2Frag-example&report=marcelgood+%28user%29
Brancheshttps://github.com/marcelgood/rag-example/branches
Tagshttps://github.com/marcelgood/rag-example/tags
https://github.com/marcelgood/rag-example/branches
https://github.com/marcelgood/rag-example/tags
11 Commitshttps://github.com/marcelgood/rag-example/commits/main/
https://github.com/marcelgood/rag-example/commits/main/
binhttps://github.com/marcelgood/rag-example/tree/main/bin
binhttps://github.com/marcelgood/rag-example/tree/main/bin
datahttps://github.com/marcelgood/rag-example/tree/main/data
datahttps://github.com/marcelgood/rag-example/tree/main/data
dbhttps://github.com/marcelgood/rag-example/tree/main/db
dbhttps://github.com/marcelgood/rag-example/tree/main/db
evalshttps://github.com/marcelgood/rag-example/tree/main/evals
evalshttps://github.com/marcelgood/rag-example/tree/main/evals
srchttps://github.com/marcelgood/rag-example/tree/main/src
srchttps://github.com/marcelgood/rag-example/tree/main/src
.env.examplehttps://github.com/marcelgood/rag-example/blob/main/.env.example
.env.examplehttps://github.com/marcelgood/rag-example/blob/main/.env.example
.gitattributeshttps://github.com/marcelgood/rag-example/blob/main/.gitattributes
.gitattributeshttps://github.com/marcelgood/rag-example/blob/main/.gitattributes
.gitignorehttps://github.com/marcelgood/rag-example/blob/main/.gitignore
.gitignorehttps://github.com/marcelgood/rag-example/blob/main/.gitignore
.node-versionhttps://github.com/marcelgood/rag-example/blob/main/.node-version
.node-versionhttps://github.com/marcelgood/rag-example/blob/main/.node-version
README.mdhttps://github.com/marcelgood/rag-example/blob/main/README.md
README.mdhttps://github.com/marcelgood/rag-example/blob/main/README.md
package-lock.jsonhttps://github.com/marcelgood/rag-example/blob/main/package-lock.json
package-lock.jsonhttps://github.com/marcelgood/rag-example/blob/main/package-lock.json
package.jsonhttps://github.com/marcelgood/rag-example/blob/main/package.json
package.jsonhttps://github.com/marcelgood/rag-example/blob/main/package.json
tsconfig.jsonhttps://github.com/marcelgood/rag-example/blob/main/tsconfig.json
tsconfig.jsonhttps://github.com/marcelgood/rag-example/blob/main/tsconfig.json
READMEhttps://github.com/marcelgood/rag-example
https://github.com/marcelgood/rag-example#rag-example-in-nodejs
Ollamahttps://ollama.com
https://github.com/marcelgood/rag-example#contents
How RAG workshttps://github.com/marcelgood/rag-example#how-rag-works
The pieceshttps://github.com/marcelgood/rag-example#the-pieces
Fileshttps://github.com/marcelgood/rag-example#files
Setuphttps://github.com/marcelgood/rag-example#setup
Ask questionshttps://github.com/marcelgood/rag-example#ask-questions
Things to tryhttps://github.com/marcelgood/rag-example#things-to-try
Part 2: questions over a relational database (text-to-SQL)https://github.com/marcelgood/rag-example#part-2-questions-over-a-relational-database-text-to-sql
Part 3: evaluating answer quality (evals)https://github.com/marcelgood/rag-example#part-3-evaluating-answer-quality-evals
The three parts of an evalhttps://github.com/marcelgood/rag-example#the-three-parts-of-an-eval
What gets measuredhttps://github.com/marcelgood/rag-example#what-gets-measured
hit@k and MRRhttps://github.com/marcelgood/rag-example#the-retrieval-measures-explained
How to use ithttps://github.com/marcelgood/rag-example#how-to-use-it
Next step: an LLM as the graderhttps://github.com/marcelgood/rag-example#next-step-an-llm-as-the-grader
Part 4: the database tools as an MCP serverhttps://github.com/marcelgood/rag-example#part-4-the-database-tools-as-an-mcp-server
Purpose-built tools instead of SQLhttps://github.com/marcelgood/rag-example#purpose-built-tools-instead-of-sql
Run ithttps://github.com/marcelgood/rag-example#run-it
What the eval showedhttps://github.com/marcelgood/rag-example#what-the-eval-showed
Use the server from Claude Codehttps://github.com/marcelgood/rag-example#use-the-server-from-claude-code
Part 5: the tool loop with the Vercel AI SDKhttps://github.com/marcelgood/rag-example#part-5-the-tool-loop-with-the-vercel-ai-sdk
Two ways to use ithttps://github.com/marcelgood/rag-example#two-ways-to-use-it
What the AI SDK does for youhttps://github.com/marcelgood/rag-example#what-the-ai-sdk-does-for-you
Other optionshttps://github.com/marcelgood/rag-example#other-options
Part 6: authentication and multi-tenancyhttps://github.com/marcelgood/rag-example#part-6-authentication-and-multi-tenancy
How a question flowshttps://github.com/marcelgood/rag-example#how-a-question-flows
Run ithttps://github.com/marcelgood/rag-example#run-it-1
Where the tenant is enforcedhttps://github.com/marcelgood/rag-example#where-the-tenant-is-enforced
The tokenshttps://github.com/marcelgood/rag-example#the-tokens
What the eval checkshttps://github.com/marcelgood/rag-example#what-the-eval-checks
What a production system addshttps://github.com/marcelgood/rag-example#what-a-production-system-adds
Part 7: better document search with LangChainhttps://github.com/marcelgood/rag-example#part-7-better-document-search-with-langchain
Four ways to find chunkshttps://github.com/marcelgood/rag-example#four-ways-to-find-chunks
Try ithttps://github.com/marcelgood/rag-example#try-it
What the eval showedhttps://github.com/marcelgood/rag-example#what-the-eval-showed-1
What LangChain did herehttps://github.com/marcelgood/rag-example#what-langchain-did-here
https://github.com/marcelgood/rag-example#how-rag-works
https://github.com/marcelgood/rag-example#the-pieces
https://github.com/marcelgood/rag-example#files
https://github.com/marcelgood/rag-example#setup
ollama.com/downloadhttps://ollama.com/download
https://github.com/marcelgood/rag-example#ask-questions
https://github.com/marcelgood/rag-example#things-to-try
https://github.com/marcelgood/rag-example#part-2-questions-over-a-relational-database-text-to-sql
https://github.com/marcelgood/rag-example#part-3-evaluating-answer-quality-evals
https://github.com/marcelgood/rag-example#the-three-parts-of-an-eval
https://github.com/marcelgood/rag-example#what-gets-measured
https://github.com/marcelgood/rag-example#the-retrieval-measures-explained
https://github.com/marcelgood/rag-example#how-to-use-it
https://github.com/marcelgood/rag-example#next-step-an-llm-as-the-grader
https://github.com/marcelgood/rag-example#part-4-the-database-tools-as-an-mcp-server
Model Context Protocolhttps://modelcontextprotocol.io
https://github.com/marcelgood/rag-example#purpose-built-tools-instead-of-sql
https://github.com/marcelgood/rag-example#run-it
https://github.com/marcelgood/rag-example#what-the-eval-showed
https://github.com/marcelgood/rag-example#use-the-server-from-claude-code
https://github.com/marcelgood/rag-example#part-5-the-tool-loop-with-the-vercel-ai-sdk
Vercel AI SDKhttps://ai-sdk.dev
https://github.com/marcelgood/rag-example#two-ways-to-use-it
https://github.com/marcelgood/rag-example#what-the-ai-sdk-does-for-you
https://github.com/marcelgood/rag-example#other-options
https://github.com/marcelgood/rag-example#part-6-authentication-and-multi-tenancy
https://github.com/marcelgood/rag-example#how-a-question-flows
https://github.com/marcelgood/rag-example#run-it-1
better-authhttps://www.better-auth.com
Honohttps://hono.dev
https://github.com/marcelgood/rag-example#where-the-tenant-is-enforced
https://github.com/marcelgood/rag-example#the-tokens
scrypthttps://en.wikipedia.org/wiki/Scrypt
https://github.com/marcelgood/rag-example#what-the-eval-checks
https://github.com/marcelgood/rag-example#what-a-production-system-adds
https://github.com/marcelgood/rag-example#part-7-better-document-search-with-langchain
LangChainhttps://js.langchain.com
https://github.com/marcelgood/rag-example#four-ways-to-find-chunks
BM25https://en.wikipedia.org/wiki/Okapi_BM25
https://github.com/marcelgood/rag-example#try-it
https://github.com/marcelgood/rag-example#what-the-eval-showed-1
Part 3https://github.com/marcelgood/rag-example#the-retrieval-measures-explained
https://github.com/marcelgood/rag-example#what-langchain-did-here
anthropichttps://github.com/topics/anthropic
better-authhttps://github.com/topics/better-auth
claudehttps://github.com/topics/claude
embeddingshttps://github.com/topics/embeddings
evalshttps://github.com/topics/evals
hybrid-searchhttps://github.com/topics/hybrid-search
lancedbhttps://github.com/topics/lancedb
langchainhttps://github.com/topics/langchain
llmhttps://github.com/topics/llm
mcphttps://github.com/topics/mcp
model-context-protocolhttps://github.com/topics/model-context-protocol
multi-tenancyhttps://github.com/topics/multi-tenancy
nodejshttps://github.com/topics/nodejs
ollamahttps://github.com/topics/ollama
raghttps://github.com/topics/rag
rerankinghttps://github.com/topics/reranking
retrieval-augmented-generationhttps://github.com/topics/retrieval-augmented-generation
text-to-sqlhttps://github.com/topics/text-to-sql
typescripthttps://github.com/topics/typescript
vercel-ai-sdkhttps://github.com/topics/vercel-ai-sdk
Readmehttps://github.com/marcelgood/rag-example#readme-ov-file
Activityhttps://github.com/marcelgood/rag-example/activity
0 forkshttps://github.com/marcelgood/rag-example/forks
Report repositoryhttps://github.com/contact/report-content?content_url=https%3A%2F%2Fgithub.com%2Fmarcelgood%2Frag-example&report=marcelgood+%28user%29
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.