Kai Personal Assistant – Starter Repo

A minimal full-stack starter for the Kai Personal Assistant MVP — a 3-lane AI interface designed to assist in real-time by listening, generating contextual responses, and presenting focused answers when needed.

This starter includes:

• NestJS backend (OpenAI-powered QA service)
• Angular frontend (three swim lanes: Listening, Response Stream, Focus)
• Docker Compose for unified local development
• Environment variable support via .env + @nestjs/config

🚀 Quick Start

1. Create your .env file

Inside api/.env:

OPENAI_API_KEY=your_key_here

2. Install all dependencies

./install-deps.sh

3. Start the full stack

docker compose up --build

Access:

• Angular → http://localhost:4200
• API → http://localhost:3000

📁 Structure

kai/
  api/
    src/
    .env
    Dockerfile
  web/
    src/
    Dockerfile
  docker-compose.yml
  install-deps.sh
  neonKAI_logo.png
  README.md

Backend

• /qa/text → text QA
• /qa/audio → audio upload
• OpenAI official SDK integrated via OpenaiService

Frontend

• Angular standalone
• Three-lane UI:
  • Listening Lane
  • Response Stream Lane
  • Focus Lane

Requirements

• Node 20+ (22 recommended)
• Docker

Security

• .env ignored by git
• API key never sent to frontend