A progressive series of AI engineering projects β from foundational LLM patterns to production-grade multi-agent systems. Each project builds on the previous, demonstrating increasing depth in system design, reliability engineering, and real-world deployment thinking.
Production-ready RAG and agent service built with LangChain and FastAPI.
Covers: Document ingestion, FAISS vector search, conversational memory, tool-use agents, prompt versioning, streaming responses (SSE), structured JSON output.
Tech: Python, FastAPI, LangChain, OpenAI, FAISS, Pydantic
Stateful multi-step agent built with LangGraph's StateGraph.
Covers: Explicit state machines, conditional edges, human-in-the-loop interrupt/resume, SQLite checkpointing for persistent state across sessions.
Tech: Python, FastAPI, LangGraph, Angular
Angular application that renders LangGraph agent execution graphs in real time.
Covers: Live agent state visualization, node/edge rendering, SSE-driven updates as the graph executes.
Tech: Angular, TypeScript, D3.js / Cytoscape
The most complete project in this portfolio. A production-grade, full-stack AI platform demonstrating every layer of enterprise AI engineering β from LLM orchestration to cloud deployment.
What it does: A user submits their birth profile. An 8-node LangGraph pipeline runs 5 domain agents in parallel (Vedic Astrology, Numerology, Palmistry, Tarot, Vastu), a meta-agent synthesises cross-domain consensus, hallucination is checked, an admin reviews and approves insights, and a branded PDF report is generated β with 30+ language translation support.
Key engineering highlights:
| Area | What Was Built |
|---|---|
| AI Pipeline | 8-node LangGraph StateGraph β security_check β question_agent β domain_agents (parallel) β meta_agent β hallucination_check β remedy_agent β admin_review_agent β grammar_agent |
| Latency | 78s (sequential GPT-4o) β 15s (parallel GPT-4o-mini) β 4s (parallel + DeepSeek + 3-tier cache) |
| LLM Cost | DeepSeek at $0.000137/analysis (500Γ cheaper than GPT-4o) |
| Caching | 3-tier: L1 in-memory + L2 Redis DB0 (connection pool, pub/sub invalidation) + L3 semantic (cosine β₯ 0.92) |
| Async Queue | Enterprise Kafka: 3 consumer workers, acks=all, gzip, exponential backoff + jitter, DLQ fallback |
| Security | 4-layer guardrail stack: input validation, prompt hardening, output validation, audit logging |
| Auth | JWT + multi-tenant RBAC (user / admin / superadmin) + OTP email |
| Observability | RAGAS proxy metrics (faithfulness, context precision, answer relevancy, domain recall) + Prometheus |
| Guardrails | G1 rate limiter, G2 circuit breaker (safe_node hard-kill timeout), G3 JSON repair cascade, G4 PII filter, G5 graceful degradation |
| Episodic Memory | Multi-tenant correction store (SQLite/PG) β every edited insight logged per tenant_id with cosine-similarity retrieval; injected into LangGraph state at /run so each tenant's pipeline learns from their own past corrections only |
| Tenant Persona Injection | Per-tenant persona prompt (custom voice, tone rules, forbidden patterns) + dynamic top-K correction recall merged into every pipeline run via tenant_preferences state key β tenants can set a custom __persona__ pref to fully override the default |
| Multi-tenant Isolation | All episodic data (corrections + persona prefs) is strictly tenant_id-scoped β Tenant A's corrections never influence Tenant B's pipeline; correction_stats_global() available to SUPER_ADMIN only |
| Fine-tune Roadmap | Phase 1 (now): per-tenant correction logging + persona prompting. Phase 2 (100+ corrections/tenant): distillation dataset. Phase 3 (500+): LoRA fine-tune on Mistral-7B |
| Feedback API | 7 tenant-scoped endpoints: POST /corrections, GET /corrections, GET /corrections/stats, POST /persona/preferences, GET /persona/preferences, GET /persona/preview β all scoped to authenticated tenant |
| Testing | 112 tests β 30 episodic memory tests (16 original + 14 new multi-tenant isolation tests, all passing), all Kafka + Redis paths mocked, no real broker needed in CI |
| Cloud | AWS ECS Fargate + ECR + GitHub Actions CI/CD (OIDC auth, rolling deploy) |
New files added (2025-05-28):
astro-intel-backend/
βββ memory/
β βββ episodic.py β multi-tenant correction store: log_correction(tenant_id, ...), retrieve_similar_corrections(tenant_id, ...), correction_stats(tenant_id), correction_stats_global()
β βββ persona.py β DEFAULT_PERSONA + build_tenant_context(query, intent, tenant_id) + format_for_prompt() + build_chandan_context() alias
βββ routers/
β βββ feedback.py β /api/v1/feedback/* β 7 tenant-scoped endpoints (ctx.tenant_id passed to all DB functions)
βββ tests/
βββ test_episodic_memory.py β 30 tests (16 original + 14 multi-tenant isolation), all passing
Modified files: database.py (init_episodic_tables on startup + live ALTER TABLE migration for tenant_id column), main.py (feedback router registered), routers/analysis.py (build_tenant_context(tenant_id=ctx.tenant_id) in /run; log_correction(tenant_id=ctx.tenant_id) in /approve), schemas/models.py (ApprovalRequest extended with edited_insights[]), metrics/collector.py (correction_stats_global() for dashboard)
Tech: Python 3.11, FastAPI, LangGraph, DeepSeek LLM, Angular 17, SQLite/PostgreSQL, Redis 7.2, Kafka (Confluent 7.6), Docker, AWS
AI-powered personal and team growth operating system using agentic workflows.
Covers: Goal decomposition, multi-step planning agents, progress tracking, structured output pipelines.
Tech: Python, FastAPI, LangChain/LangGraph, Angular
Automated report generation system using LLM pipelines.
Covers: Document analysis, structured report generation, multi-section synthesis, export workflows.
Tech: Python, FastAPI, OpenAI, Angular
AI-assisted resource allocation and optimization tool for engineering teams.
Covers: Skill matching, capacity analysis, LLM-driven recommendations, structured decision outputs.
Tech: Python, FastAPI, OpenAI, Angular
AI tutoring and knowledge assistant application.
Covers: Personalized Q&A, adaptive responses, knowledge retrieval, conversational AI patterns.
Tech: Python, FastAPI, OpenAI, Angular
This repository follows a trunk-based branching model with environment gates. Every merge to production goes through a human-approved promotion step β no direct push to main is allowed.
feature/* ββPRβββ develop ββPRβββ staging ββpromote.ymlβββ main
hotfix/* ββββββββββββββββββββββββββββββββββββββββββββββββββββββ main
| Branch | Purpose | Deploys to |
|---|---|---|
main |
Production-ready code only. No direct push β only promote.yml merges here. |
AWS ECS prod cluster (astrointel-cluster) |
staging |
Pre-production verification. Merged from develop via PR. |
AWS ECS staging cluster (astrointel-staging-cluster) |
develop |
Integration of all features. Merged from feature/* via PR. |
No deploy β CI tests only |
feature/* |
One branch per feature or fix. Always cut from develop. |
No deploy |
hotfix/* |
Emergency production fix. Cut from main, promoted directly. |
No deploy |
# Start new work β always from develop
git checkout develop && git pull origin develop
git checkout -b feature/your-feature-name
# Work, commit, push
git commit -m "feat: description"
git push origin feature/your-feature-name
# Open PR: feature/your-feature-name β develop
# CI must pass (pytest + ng build) before merge is allowed1. PR: feature/* β develop CI gate (test.yml): pytest + ng build
2. PR: develop β staging CI gate again + auto-deploy to staging ECS
3. Verify staging manually https://staging.aurawithrav.com
4. Run promote.yml (manual) GitHub Actions β requires production approver
ββ Verifies staging ECS health
ββ Merges staging β main
ββ Triggers build-push.yml on main
ββ Triggers deploy.yml β prod ECS rolling update
ββ Syncs develop with main
| Workflow | Triggers on | What it does |
|---|---|---|
test.yml |
PR to develop/staging/main + push to develop | pytest + ng build β pure CI gate |
build-push.yml |
Push to staging or main | Inline test gate β Docker build β ECR push (:staging or :latest + :<sha>) |
deploy.yml |
After build-push on staging/main | ECS rolling update β auto-selects cluster based on branch |
promote.yml |
Manual dispatch only | Verifies staging health β merges stagingβmain β triggers full prod deploy chain |
| Branch | Tags |
|---|---|
staging |
:staging + :<8-char-sha> |
main |
:latest + :<8-char-sha> |
Always reference images by SHA tag in production β SHA tags are immutable; :latest is not.
Full details: see BRANCH_STRATEGY.md
ai-engineer/ β repo root (monorepo)
βββ astro-intel/ β Angular 17 frontend (AstroIntel 360Β°)
βββ astro-intel-backend/ β FastAPI + LangGraph backend (AstroIntel 360Β°)
β βββ docker-compose.yml β Enterprise stack (Kafka + Redis + UIs)
βββ bench-resource-optimizer/ β Bench project
βββ langchain_project/ β Interview demo
βββ senior-ai-engineer/ β Study materials / interview prep (12 modules)
βββ .github/workflows/ β All CI/CD workflows
βββ docker-compose.yml β Simple dev stack (SQLite, no Kafka/Redis)
βββ BRANCH_STRATEGY.md β Full branching strategy documentation
βββ PRODUCTION_DEPLOYMENT_GUIDE.md β AWS/ECS deployment guide
βββ README.md β This file
Two docker-compose files:
| File | Use when |
|---|---|
Root docker-compose.yml |
Local dev β simple SQLite stack, no Kafka/Redis overhead |
astro-intel-backend/docker-compose.yml |
Full enterprise stack β Kafka, Redis, ZooKeeper, admin UIs |
| Layer | Technology |
|---|---|
| LLM APIs | DeepSeek (primary), OpenAI GPT-4o / GPT-4o-mini |
| Agent Framework | LangGraph, LangChain |
| Backend | Python 3.11, FastAPI, Uvicorn |
| Async Queue | Apache Kafka (Confluent 7.6), kafka-python-ng |
| Cache | Redis 7.2 (L2 response cache + L1 in-memory + L3 semantic) |
| Vector Store | FAISS, pgvector |
| Frontend | Angular 17, TypeScript, SSE |
| Auth | JWT, RBAC, OTP email |
| DevOps | Docker, GitHub Actions (OIDC, no long-lived keys) |
| Cloud | AWS ECS Fargate, ECR, ap-south-1 |
Phase 1 β Foundation
langchain_project Basic RAG + agents + streaming
Phase 2 β State & Orchestration
langraph_project Stateful agents, interrupt/resume
graph-visualizer Real-time agent graph visualization
Phase 3 β Production Multi-Agent
astro-intel Parallel agents, consensus, guardrails, Kafka, Redis
Phase 4 β Domain Applications
agentic-growth-os Growth planning automation
ai-report-app Document intelligence
bench-resource-optimizer Resource optimization
guru-app Adaptive tutoring
Rav Singh Chandan β Senior AI Engineer
6+ years background in Java, Spring Boot, Angular, DevOps, and Cloud (AWS/GCP). Now building production AI systems: multi-agent pipelines, LLM guardrails, semantic caching, and full-stack AI applications.
The AstroIntel 360Β° project is the most complete demonstration of these skills β it is not a tutorial follow-along. Every component β the 8-node LangGraph graph, the 3-tier Redis cache, the enterprise Kafka pipeline, the RBAC system, the G1βG5 guardrail stack, the CI/CD pipeline β was designed and built from scratch to solve real production problems.
Available for Senior AI Engineer, AI Platform Engineer, and Full-Stack AI Engineer roles.