# Build Paths Beginner

Scaffold a small RAG chatbot on Oracle 26ai Free + langchain-oracledb + OCI Generative...

- Repository: https://github.com/oracle-devrel/oracle-ai-developer-hub (4464 stars)
- Category: Documents
- License: see repository
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add oracle-devrel/oracle-ai-developer-hub --skill build-paths-beginner -g -a claude-code -y`
Codex: `npx skills add oracle-devrel/oracle-ai-developer-hub --skill build-paths-beginner -g -a codex -y`
Cursor: `npx skills add oracle-devrel/oracle-ai-developer-hub --skill build-paths-beginner -g -a cursor -y`
Gemini CLI: `npx skills add oracle-devrel/oracle-ai-developer-hub --skill build-paths-beginner -g -a gemini-cli -y`

## Description

Scaffold a small RAG chatbot on Oracle 26ai Free + langchain-oracledb + OCI Generative AI Grok 4 + sentence-transformers MiniLM-L6-v2 (Python-side embeddings, same model intermediate/advanced register inside Oracle) + Open WebUI. Three flavors that share one skeleton, PDF / Markdown / Web. For users new to Oracle who want a polished demo running in an afternoon.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

The user picked the **beginner** path. Your job is to interview them, scaffold a working project that ingests a corpus and exposes a Grok-4-powered chat UI in Open WebUI, run verify, and stop. The output is a real shippable mini-product, not a tutorial.

## Step 0, Read these references first (mandatory)

- `shared/references/sources.md`
- `shared/references/oracle-26ai-free-docker.md`
- `shared/references/langchain-oracledb.md`  ← load-bearing
- `shared/references/oci-genai-openai.md`  ← load-bearing (Pattern 1 SigV1 auth)
- `shared/references/oracledb-python.md` (skim, beginner only touches `oracledb.connect`)
- `shared/references/exemplars.md`
- `beginner/project-ideas.md`
- `skills/oracle-aidb-docker-setup/SKILL.md`, you'll invoke this
- `skills/langchain-oracledb-helper/SKILL.md`, you'll invoke this

You may not write SQL, embedder calls, or table-creation code that contradicts these files. If the user asks for something not covered, say so and stop, don't invent.

## Step 1, Interview

Run the questions from `shared/interview.md`. For beginner specifically:

The rest: https://github.com/oracle-devrel/oracle-ai-developer-hub/blob/HEAD/build-paths/beginner/SKILL.md
