🤖 Miles Assistant

AI-Powered Workplace Platform

"Siri har mye på agendaen, så vi introduserer Miles Assistant – intelligent workspace management through multiple interfaces"

🌟 What is Miles Assistant?

Miles Assistant started as a room booking system, but has evolved into a comprehensive AI-powered workplace platform with six different interfaces, natural language processing, and intelligent automation. Whether you prefer a HAL-9000 terminal, conversational chat, visual web interface, or scriptable CLI—Miles Assistant adapts to how you work.

graph TB
    subgraph Interfaces["🎨 Six Ways to Interact"]
        IRIS[🔴 IRIS Terminal<br/>HAL-9000 Inspired]
        CHAT[💬 Chat Assistant<br/>Natural Language]
        WEB[🌐 Web App<br/>Visual Interface]
        TUI[🎨 Terminal UI<br/>Bubble Tea]
        CLI[⌨️ CLI<br/>Scriptable]
        MOBILE[📱 Mobile<br/>Slack + ESP32]
    end

    subgraph Core["🧠 AI Core"]
        MCP[Model Context Protocol]
        LLM[Multi-LLM Support<br/>Ollama, OpenAI, Claude]
        API[REST API + Auth]
    end

    subgraph Backend["💾 Backend"]
        DB[(PostgreSQL<br/>Prisma ORM)]
        TOOLS[Booking Tools<br/>Rooms, Users, Calendar]
    end

    IRIS --> MCP
    CHAT --> MCP
    WEB --> API
    TUI --> API
    CLI --> API
    MOBILE --> API

    MCP --> LLM
    MCP --> API
    API --> TOOLS
    TOOLS --> DB

    style IRIS fill:#330000,stroke:#ff0000,color:#fff
    style CHAT fill:#1a1a2e,stroke:#0f3460,color:#fff
    style Core fill:#2d3436,stroke:#fdcb6e,color:#fff
    style Backend fill:#2d3436,stroke:#00b894,color:#fff

🎯 Choose Your Interface

Interface	Best For	Technology	Port	Documentation
🔴 IRIS	Power users who love retro-futuristic terminals	Node.js + HAL-9000 CSS	3002	📖 IRIS Docs
💬 Chat	Natural conversation and AI assistance	Node.js + Multi-LLM	3001	📖 Chat Docs
🌐 Web	Visual, mobile-friendly experience	React + TypeScript	5173	📖 Web Docs
🎨 TUI	Terminal enthusiasts and keyboard warriors	Go + Bubble Tea	-	📖 TUI Docs
⌨️ CLI	Automation, scripting, CI/CD	Go + Cobra	-	📖 CLI Docs
📱 Mobile	Slack teams and room displays	Integration Guides	-	📖 Guides

✨ Standout Features

🤖 AI-First Design

Natural Language Processing: Talk to your booking system like a colleague
Multi-LLM Support: Choose between Ollama (local), OpenAI, or Anthropic
Model Context Protocol: Standardized AI tool integration across all interfaces
Intelligent Suggestions: AI recommends available times, rooms, and resolves conflicts

🎨 Multiple Interfaces

IRIS Terminal: HAL-9000 inspired with CRT scanlines, pulsing red eye, typing animations
Chat Assistant: Modern chat UI with markdown rendering, tables, and streaming responses
Web App: React SPA with shadcn/ui components and dark mode
Terminal UI: Vim keybindings, beautiful TUI built with Bubble Tea
CLI: Fast, scriptable commands for automation
Integrations: Slack bot guide, ESP32 display guide

🔒 Type Safety Everywhere

OpenAPI-First: Single source of truth (api/openapi.yaml)
Generated Clients: TypeScript and Go types auto-generated
End-to-End Safety: From database to frontend

🏢 Enterprise Ready

Multi-location: 7 offices across Norway and Lithuania
Role-based Access: Admin, Manager, User roles
Real-time Conflict Detection: Prevent double-bookings
Calendar Integration: iCal export for Google Calendar, Outlook
Feedback System: Room feedback with resolution workflows

🚀 Quick Start

Prerequisites

What you'll need (click to expand)

Required:

Node.js 20.x or higher
PostgreSQL (or Docker)

Optional (depending on interface):

Go 1.24.3+ (for TUI/CLI)
Docker & Docker Compose (for containerized deployment)
Ollama (for local AI, recommended)

For AI Features: Choose one:

🦙 Ollama (local, free, private)
🤖 OpenAI API key (ChatGPT)
🧠 Anthropic API key (Claude)

One-Command Setup

# Clone and setup everything
git clone <repo-url> miles-assistant
cd miles-assistant
./start-dev.sh

This automatically:

✓ Checks prerequisites (Docker, Ollama)
✓ Pulls LLM model if needed
✓ Starts PostgreSQL in Docker
✓ Runs database migrations and seeding
✓ Starts API on port 3000
✓ Starts Chat Assistant on port 3001
✓ Performs health checks
✓ Shows you URLs and credentials

Access Your Interfaces

After setup completes:

Interface	URL	Credentials
API Documentation	http://localhost:3000/api-docs	N/A
Chat Assistant	http://localhost:3001	Login required
IRIS Terminal	http://localhost:3002	Login required
Web App	http://localhost:5173	Login required

Test Accounts (all passwords: password123):

Admin: admin@miles.com
Manager: manager.stavanger@miles.com
User: john.doe@miles.com

Choose Your Adventure

Want the HAL-9000 experience?

cd iris
npm start
# Open http://localhost:3002

Prefer chat?

cd chat-app
npm start
# Open http://localhost:3001

Go developer?

./install.sh           # Installs TUI and CLI
miles-booking          # Launch TUI
miles login user@mail  # Use CLI

Just want the web UI?

cd web
npm install
npm run dev  # http://localhost:5173

📚 Documentation

Core Documentation

📖 Getting Started Guide - Detailed setup for all components
🏗️ Architecture Overview - System design and data flow
📖 Legacy Booking Docs - Original comprehensive docs

Interface Documentation

🔴 IRIS - HAL-9000 terminal assistant
💬 Chat Assistant - AI-powered chat with markdown
🌐 Web App - React frontend
🎨 TUI - Terminal interface
⌨️ CLI - Command-line tools

API & Integration

🔌 API Documentation - REST API reference
🤖 MCP Integration - Model Context Protocol
📝 OpenAPI Spec - Interactive docs at /api-docs
💬 Slack Bot Guide - Slack integration
📺 ESP32 Display Guide - Room displays

Implementation Guides

📋 Feedback System - Room feedback workflows
🛠️ Setup Guide - Manual setup instructions
⚡ Quick Start - Fast track setup

🏗️ Architecture Overview

Technology Stack

Component	Technology	Purpose
API	Node.js, Express, TypeScript, Prisma	Core backend with REST API and MCP server
IRIS	Node.js, Express, Vanilla JS	HAL-9000 inspired terminal assistant
Chat	Node.js, Express, marked.js	AI chat with markdown rendering
Web	React, TypeScript, Vite, shadcn/ui	Modern web application
TUI	Go, Bubble Tea, Lipgloss	Beautiful terminal interface
CLI	Go, Cobra	Scriptable command-line tool
Database	PostgreSQL, Prisma ORM	Persistent data storage
AI Layer	Ollama / OpenAI / Anthropic	Natural language processing
Protocol	Model Context Protocol (MCP)	Standardized AI tool interface

Project Structure

miles-assistant/
├── api/                    # 🔌 REST API & MCP Server
│   ├── src/
│   │   └── mcp/            # Model Context Protocol tools
│   ├── prisma/             # Database schema & migrations
│   └── openapi.yaml        # OpenAPI specification
│
├── iris/                   # 🔴 HAL-9000 Terminal Assistant
│   ├── public/             # Frontend (HTML/CSS/JS)
│   ├── server.js           # MCP client + LLM integration
│   └── llm-providers.js    # Multi-LLM abstraction
│
├── chat-app/               # 💬 AI Chat Assistant
│   ├── public/             # Frontend with markdown rendering
│   ├── server.js           # Express + MCP + LLM
│   └── llm-providers.js    # Multi-LLM support
│
├── web/                    # 🌐 React Web App
│   ├── src/
│   │   ├── components/     # shadcn/ui components
│   │   ├── lib/api/        # Generated API client
│   │   └── pages/          # App routes
│   └── package.json
│
├── tui/                    # 🎨 Terminal UI (Go)
│   ├── internal/
│   │   ├── generated/      # OpenAPI-generated types
│   │   └── ui/             # Bubble Tea views
│   └── Makefile
│
├── cli/                    # ⌨️ CLI (Go)
│   ├── internal/
│   │   ├── generated/      # OpenAPI-generated types
│   │   └── commands/       # Cobra commands
│   └── Makefile
│
├── docs/                   # 📚 Integration Guides
│   ├── SLACK_BOT_GUIDE.md
│   └── ESP32_DISPLAY_GUIDE.md
│
├── ARCHITECTURE.md         # System architecture deep-dive
├── GETTING_STARTED.md      # Comprehensive setup guide
├── docker-compose.yml      # Container orchestration
├── start-dev.sh            # Development startup script
└── install.sh              # CLI/TUI installer

🎮 Example Workflows

Natural Language Booking (IRIS or Chat)

> I need a room for 6 people tomorrow at 2pm

IRIS: I found Teamrommet which seats 8 people. Would you like
      to book it for 1 hour starting at 2:00 PM?

> yes, make it 2 hours

IRIS: ✓ Booked Teamrommet for 2025-10-21 from 14:00-16:00

CLI Automation

# Script to book daily standup
#!/bin/bash
miles book \
  --room "Focus Room" \
  --start "$(date +%Y-%m-%d) 09:00" \
  --duration 15 \
  --title "Daily Standup" \
  --recurring weekly

TUI Power User

Press 'q' for quick book
Select room with j/k
Press Enter to book
Press '/' to search

🧪 Development

Start Development Environment

# Start everything (database, API, chat-app)
./start-dev.sh

# Check status of all services
./status.sh

# View logs (interactive menu)
./logs.sh

# Stop all services
./stop-dev.sh

Individual Component Development

API:

cd api
npm run dev              # Hot reload
npm run prisma:studio    # Database GUI

IRIS:

cd iris
npm run dev              # Hot reload (node --watch)

Chat:

cd chat-app
npm start

Web:

cd web
npm run dev
npm run generate         # Regenerate API client

TUI/CLI:

cd tui  # or cd cli
make generate            # Generate types from OpenAPI
make build
make run

🐳 Docker Deployment

Complete Docker setup with nginx reverse proxy - 📖 Full Docker Documentation

One-Command Start

# Start all services (database, API, chat, IRIS, web, nginx)
docker-compose up -d

Access Everything via Nginx (Port 80):

🌐 Web Frontend: http://localhost/
🔌 API: http://localhost/api/
💬 Chat: http://localhost/chat/
🔴 IRIS: http://localhost/iris/

Or Direct Service Access:

Development with Hot-Reload

# Use development config with volume mounts
docker-compose -f docker-compose.yml -f docker-compose.dev.yml up

# Or hybrid: Database in Docker, services local
docker-compose up -d postgres
cd api && npm run dev
cd web && npm run dev

See README-DOCKER.md for:

📋 Detailed setup instructions
🔧 Development workflows
🐛 Troubleshooting guide
🚀 Production deployment

🌍 Office Locations

Miles Assistant supports 7 office locations:

🇳🇴 Norway

Stavanger (5 meeting rooms)
Haugesund
Oslo
Bergen
Ålesund
Innlandet (Lillehammer)

🇱🇹 International

Lithuania (Vilnius)

🤝 Contributing

This is a Miles internal project. For development guidelines, see:

Architecture Documentation
Getting Started Guide
Individual component READMEs

📄 License

MIT License - see LICENSE file for details

⭐ Powered By

Model Context Protocol • OpenAPI • Ollama • Prisma

Built with ❤️ for Miles

From a booking system to a full AI assistant platform

Name		Name	Last commit message	Last commit date
Latest commit History 96 Commits
.husky		.husky
api		api
chat-app		chat-app
cli		cli
docs		docs
iris		iris
nginx		nginx
tui		tui
web		web
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
AGENTS.md		AGENTS.md
ARCHITECTURE.md		ARCHITECTURE.md
BOOKING_SYSTEM_LEGACY.md		BOOKING_SYSTEM_LEGACY.md
FEEDBACK_IMPLEMENTATION_GUIDE.md		FEEDBACK_IMPLEMENTATION_GUIDE.md
GETTING_STARTED.md		GETTING_STARTED.md
Makefile		Makefile
QUICKSTART.md		QUICKSTART.md
README-DOCKER.md		README-DOCKER.md
README.md		README.md
SETUP.md		SETUP.md
biome.json		biome.json
docker-compose.dev.yml		docker-compose.dev.yml
docker-compose.yml		docker-compose.yml
install.sh		install.sh
logs.sh		logs.sh
package.json		package.json
setup.sh		setup.sh
start-dev.sh		start-dev.sh
status.sh		status.sh
stop-dev.sh		stop-dev.sh

miles-no/assistant

Folders and files

Latest commit

History

Repository files navigation