kindai

A model-agnostic AI assistant CLI + browser workspace UI for the KindPath ecosystem. Built in Python 3.12. Runs offline with Ollama or via paid APIs (Claude, OpenAI, Gemini).

Quick Start

# Activate venv
source /Users/sam/kindai/venv/bin/activate

# CLI — interactive REPL
kindai

# One-shot
kindai "what is the state of kindpath-dfte?"

# Workspace UI (4-panel browser interface)
kindai-workspace
# Opens http://localhost:7860

Backends

Backend	Config	Notes
ollama	localhost:11434	Default — offline, requires ollama pull llama3.2
claude	ANTHROPIC_API_KEY	Claude Sonnet 4.6
openai	OPENAI_API_KEY	GPT-4o
gemini	GEMINI_API_KEY	Gemini Pro
github	GITHUB_TOKEN	GitHub Models

kindai --backend claude "analyse the DFTE backtest results"

Structure

kindai.py              — CLI entry point (Click)
core/                  — config, backend (litellm), sessions (SQLite), renderer
tools/                 — bash, file, web, kindpath tool dispatch
products/              — per-product AI overlays (kindis, kindcare, kindhome, etc.)
shared/                — shared FastAPI base, DB utilities
workspace/             — FastAPI server + single-file HTML UI (no build step)
missions/              — scheduled background tasks
ndis/                  — NDIS intake, case notes, field guides
transcripts/           — auto-saved Markdown session transcripts

Products

The products/ directory contains product-specific AI overlays:

Product	Domain
kindis	NDIS / disability services
kindcare	Aged care
kindhome	Housing and homelessness
kindwork	Employment and workplace
kindbiz	Ethical business
kindcreate	Creative and arts
kindlife	General life navigation

Cloud Deployment

The kindai workspace is deployed to Cloud Run at: https://kindai-jln7q4sk7a-ts.a.run.app

Requires Google OAuth login. Uses Cloud SQL (Postgres 15) with Alembic migrations that run automatically on startup.

Security

• No API keys or secrets in source control
• All credentials via .env (local) or Secret Manager (Cloud Run)
• File tool path access is enforced via allowed_paths config