← Back to work
Thenali AI — social share cover
Social share preview · 1200 × 630
AI Platform · 2025

Thenali AI

Developer Learning & Repository Intelligence

Reading a large open-source repo cold is a wall. Docs lie, READMEs are stale, and the actual architecture only lives in the code. Thenali AI turns any repo into a paced, explainable learning path grounded in the real source tree.

Role
Backend + AI pipeline lead — ingestion, embeddings, roadmap generation.
Timeline
10 weeks
PythonFastAPIBedrockFAISSDynamoDBS3
01 · Challenges

What was hard.

01

Making explanations faithful to the code

LLMs summarise confidently and wrongly. Every explanation is tied back to a file:line range retrieved from FAISS, so users can verify against source in one click.

02

Adaptive pacing without a user model

Cold-start learners have no signal. The roadmap starts with entrypoints + config, then branches by module coupling — a graph-first curriculum, not a chapter list.

03

Multilingual without translation drift

Explanations are generated in the target language directly via Bedrock rather than post-translated, preserving code term accuracy. The interface supports 12 Indian languages natively.

02 · Architecture

How it fits together.

Repo → chunk → embed → roadmap → chat

  • ▸S3 holds raw repos; FAISS index is per-repo and rebuilt on push.
  • ▸DynamoDB tracks learner progress cheaply at read-heavy scale.
GitHub repo URL
any public repo
S3
raw files
Ingestor
clone + snapshot
S3
raw files
Chunker + AST parser
semantic slicing
FAISS
per-repo index
Embeddings (Bedrock)
per-symbol vectors
FAISS
per-repo index
DynamoDB
learner state
Roadmap Generator
entrypoint-first path
DynamoDB
learner state
FastAPI Chat
grounded in file:line
03 · Outcomes

What shipped.

12
Indian languages supported in the interface UI
≤30s
repo → first lesson (design target, not benchmarked)
file:line
grounding approach for explanations
04 · Learnings
  • —Grounding beats fluency. Users trust an ugly citation more than a smooth paragraph.
  • —Entrypoint-first roadmaps mirror how senior engineers actually read code.
05 · Evidence

What the evidence supports.

Evidence status

The file-and-line-grounded explanation approach, the repository-to-roadmap pipeline, and the 12-language interface UI are working features. First-lesson timing and citation coverage are listed as design targets; they have not been measured in a formal evaluation.