Dashboard
Login

Komrade: No Veteran Left Behind

AI-powered gradual reintegration for the 200,000 veterans who transition to civilian life every year. Built in 24 hours. Designed for the quiet battles that rarely make headlines.

Inspiration

Each year, over 200,000 veterans transition into civilian life. Many struggle not because they lack strength, but because civilian reintegration is unstructured, socially overwhelming, and emotionally isolating.

We’re often shown dramatic portrayals of PTSD — like in Brothers, where Tobey Maguire’s character returns from war visibly changed, unable to reconnect, misunderstood by those closest to him. That scene captures something deeper than trauma: the silent distance between military experience and civilian life.

But for most veterans, reintegration isn’t a single explosive moment — it’s small daily interactions. A crowded coffee shop. A job interview question. A dinner conversation that feels impossible to navigate.

Existing solutions are reactive (crisis hotlines) or fragmented (job boards, therapy apps). We were inspired to build something preventive — a system that supports veterans before crisis, through gradual, evidence-based confidence building.

Komrade is designed for the quiet, everyday battles that rarely make it into movies — but define the real transition home.

What it does

Imagine this:

You're a veteran. Three months out. The VA says: "You're fine, just adjust."

Everyone else says: "Just put yourself out there!"

But you can't. The grocery store feels overwhelming. A job interview? Impossible.

That's where Komrade starts.

🎯 Your Journey (AI-Powered Social Ladder)

Challenge 1: Coffee with a friend. At your home. 15 minutes. No pressure.

Challenge 8 (8 weeks later): Veteran networking event. 50+ people.

Each challenge is personalized based on:

Your anxiety triggers (crowds? Noise? Unpredictability?)
Your interests (fitness? Coffee? Gaming?)
Your goals (leave the house? Get a job? Make friends?)

Not generic advice. Not "just try harder." A roadmap built for YOU.

Options, not orders. Morning or afternoon. This place or that. With a buddy or solo.

You control the how. We guide the what.

💬 KomradeAI Chat (24/7 Support)

Nervous before Challenge 3? Ask for help.

Job interview coming up? Practice translating military experience into civilian language.

"I led a 12-person infantry squad" → "I managed cross-functional teams under high-pressure deadlines."

Crisis-safe responses. Military-to-civilian translation. Always available.

🆘 Buddy SOS Network (Proactive Peer Support)

Daily mood check-in: "How are you feeling today?"

😄 Great | 🙂 Good | 😐 Okay | 😔 Struggling | 😰 Need Help

Select "Need Help" → Crisis resources open automatically + nearby veteran buddies are notified.

Not a hotline. Not after-the-fact. Real-time peer support before crisis hits.

Battle buddies don't leave each other behind.

🔒 Privacy & Safety First

Crisis resources always one click away (Veterans Crisis Line: 988 → 1)
Encrypted data, privacy-first design
Clear disclaimers: "We complement professional care, not replace it"
Designed WITH clinical psychologists, not just for them

👥 Our Approach

We're not building another meditation app. We're building evidence-based exposure therapy — personalized, accessible, and veteran-specific.

Design Principles:

✅ Start below anxiety level (Challenge 1 should feel easy)
✅ Options, not mandates (respect for veteran autonomy)
✅ Crisis prevention, not intervention (catch them before the fall)
✅ Peer support, not just professionals (battle buddies matter)
✅ Honor-system based (no surveillance, no shame)

Clinical Foundation: Gradual exposure therapy is proven effective for PTSD and social anxiety. But it's usually only available through 6-month VA waitlists.

Komrade makes it accessible. Today. For free.

💡 Why This Matters

The Gap We're Filling:

Today, veterans have two options:

Crisis hotlines (reactive, only after things fall apart)
Generic wellness apps (meditation, journaling — not veteran-specific)

What's missing? Prevention. Gradual skill-building. Veteran-specific support.

The data shows the need:

60% of veterans report difficulty with social reintegration (VA, 2023)
Average VA therapy waitlist: 6 months
Social isolation is the #1 predictor of veteran suicide risk

Komrade bridges the gap between "I'm fine" and "I'm in crisis" — the space where most veterans actually live.

We catch them on the ladder, not at the bottom of the cliff.

How we built it

🖥 Frontend:

React + TypeScript + Vite (main application) React Router (routing) Custom state management via Context/hooks WebSocket client integration (SOS events & notifications)

⚙️ Backend:

Python + FastAPI (API layer) SQLAlchemy (ORM) Alembic (database migrations) Pydantic v2 (schema validation & serialization) JWT Authentication (python-jose) Password hashing (passlib) Motor (MongoDB async driver)

🗄 Database:

PostgreSQL (primary relational database) MongoDB (secondary store for translation history & unstructured AI logs)

🤖 AI / LLM & Intelligence Layer:

Gemini API (structured generation & reasoning) Ollama (local models) behind a unified AI service abstraction ElevenLabs Speech-to-Text API (multipart audio upload endpoint)

🧪 Testing:

Pytest (backend testing) Vitest (frontend unit testing) React Testing Library (component testing)

📦 Other in Repository:

Next.js scaffold under apps/web (secondary frontend setup) Legacy FastAPI scaffold under apps/api (older backend structure)

We built phase-wise, ensuring each feature ran end-to-end locally before layering additional complexity.

Challenges we ran into

Keeping two frontend/backends in one repo (frontend, apps/web, backend, apps/api) aligned without breaking active flows.
Handling provider differences for AI and STT (Gemini/Ollama structured output + ElevenLabs endpoint variations).
Debugging environment/config issues (.env loading path, proxy routes like /stt, local/cloud Mongo connectivity/auth errors).
Managing realtime SOS behavior so actions show up correctly across Dashboard, Inbox, and SOS History.
Preventing frontend state/ID mapping bugs (for example buddy selection and role-dependent buddy IDs).

Accomplishments that we're proud of

In 24 hours, we built:

✅ End-to-end AI ladder generation with pluggable providers (Gemini + Ollama) and structured validation
✅ Crisis-safe chat system with military-to-civilian translation and persistent history
✅ Real-time SOS network with WebSocket-driven buddy notifications
✅ Voice input integration (browser → backend → ElevenLabs STT → transcript autofill)
✅ Complete auth flow (JWT, buddy links, mood check-ins, location tracking)
✅ Thoughtful UX designed for veterans experiencing anxiety (no red colors, supportive language, options not mandates)

Most importantly: We built something that could actually save lives.

Not just code. A mission.

What we learned

Small config mismatches (env_file resolution, Vite proxy entries) can cause “feature broken” symptoms even when code is correct.
Cross-role data models (veteran vs buddy) require careful “other user” mapping in UI to avoid subtle logic bugs.
For LLM integrations, schema enforcement and retry/correction prompts are essential for reliable downstream behavior.
Realtime features work best when paired with explicit refresh logic and deterministic backend status transitions.
Incremental, non-destructive changes are safer and faster in a prototype with multiple parallel code paths.