ai-course-example: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Purpose

Educational examples for building chatbots and AI agents with LLMs, organized as independent modules demonstrating progressive complexity: direct API usage → LangChain framework → full-stack apps → agentic loops.

Running Code

All modules are standalone Python scripts. Run them directly:

python backend_api/test_chat_simple.py
python backend_langchain/test_05_rag.py
python ai_agent/test_loop_agent.py
python embedding_test/run_embedding_search.py

Required environment variables (.env file):

• OPENAI_API_KEY (for backend_api/, backend_langchain/, fullstack_flask/)
• ANTHROPIC_API_KEY (for ai_agent/)
• PINECONE_API_KEY (for Pinecone examples)
• TAVILY_API_KEY (for ai_agent/test_chat_with_rag.py)

fullstack_flask app

pip install -r fullstack_flask/requirements.txt

# Initialize DB (first time only)
python -c "from src.app import app, db; app.app_context().__enter__(); db.create_all()"

gunicorn src.app:app        # http://localhost:50505
docker-compose up           # alternatively

notebook_app_by_cc

# Backend (Django) — http://localhost:8000
cd notebook_app_by_cc/backend
pip install -r requirements.txt
python manage.py migrate        # first time only
python manage.py runserver

# Frontend (React + Vite) — http://localhost:5173
cd notebook_app_by_cc/frontend
npm install
npm run dev

Start the backend first; Vite proxies /api/* to localhost:8000. See notebook_app_by_cc/CLAUDE.md for full architecture details.

fullstack_flask_minimal

flask --app src.app run     # http://0.0.0.0:5000

Architecture

Module Overview

Module	Purpose
embedding_test/	GloVe word embeddings + cosine similarity, no API required
backend_api/	OpenAI SDK examples (simple → streaming → multi-turn → function calling → agents)
backend_langchain/	LangChain equivalents (prompts, memory, RAG, tool-calling agents)
fullstack_flask/	Production-style Flask app with RAG, streaming, DB persistence
fullstack_flask_minimal/	Minimal Flask starter template
ai_agent/	Agentic loops with tool execution and context window visualization (Anthropic SDK, claude-sonnet-4-6)
notebook_app_by_cc/	Full-stack notebook app: Django REST Framework backend + React 19 SPA frontend with JWT auth and rich text editing