OS Assistant - Personal AI Assistant banner

OS Assistant - Personal AI Assistant

2 devlogs
15h 26m 1s

OS Assistant is a personal AI assistant with a modern web interface, deployed in production with automated tests and real-time monitoring.

Features:

  • FastAPI backend + LLM integration
  • Modern interface with dark mode and animations
  • Automated tests (pytest + Selenium)
  • CI/CD pipeline (GitHub Actions)
  • Production deployment (Render + GitHub Pages)
  • UptimeRobot monitoring with live status badges

Tech Stack: Python, FastAPI, HTML/CSS/JS Vanilla, SQLite, Selenium

This project uses AI

Development assisted by GitHub Copilot (Claude Sonnet 4.5):

  • Architecture planning and task breakdown
  • Educational explanations of concepts (pytest, Selenium, FastAPI, CORS, etc.)
  • Debugging assistance
  • Code review and improvement suggestions
Demo Repository

Loading README...

Xyon

OS Assistant - Development Log #2
Date: February 5, 2026
Developer: Xyon
Status: v1.1.0 Released

What’s New

This update focuses on production-grade monitoring, cloud database persistence, and CI/CD reliability improvements following the initial v1.0.0 release.

Key Features Added

Monitoring System - Complete observability with dedicated endpoints:

  • /health - Real-time health checks with uptime tracking
  • /metrics - Request counters and human-readable uptime
  • /stats - Database statistics (average response times, error rates)
  • Production logs persisted in cloud database with UTC+1 timestamps

PostgreSQL Migration - Moved from SQLite to cloud database:

  • Supabase PostgreSQL with Session Pooler (IPv4 compatibility)
  • Persistent logs survive backend redeployments
  • UptimeRobot monitoring keeps database and backend active 24/7

Testing Improvements - Enhanced CI/CD reliability:

  • Implemented unittest.mock for database-free testing in GitHub Actions
  • All 5 backend tests pass without DATABASE_URL environment variable
  • Fixed workflow to use requirements.txt for consistent dependencies

What I Learned

Database Challenges - Discovered ephemeral filesystems on Render delete SQLite files on every redeploy. Solution: migrate to cloud Postgres with always-on free tier (Supabase).

The Result

Production application with professional monitoring, persistent cloud storage, and robust CI/CD pipeline. Every feature built with full understanding of dependencies, testing strategies, and deployment considerations.

Demo: https://xyon15.github.io/os-assistant/
GitHub: https://github.com/Xyon15/os-assistant
Release: https://github.com/Xyon15/os-assistant/releases/tag/v1.1.0
License: GPL v3
Version: 1.1.0

Attachment
0
Xyon

OS Assistant - Development Log #1

Date: February 3, 2026
Developer: Xyon
Status: v1.0.0-stable Released


The Journey

This project demonstrates building a complete AI assistant from scratch with full understanding of every component and deployment to production with professional development practices.

What I Built

OS Assistant is a personal AI chat application with a modern web interface. Users can have conversations with LLM through a clean, responsive UI with dark mode support. The entire system is deployed in production with automated testing and real-time monitoring.

The long-term goal is to evolve this into a desktop application that serves as an intelligent productivity companion, while maintaining simplicity and extensibility.

Tech Stack

Backend: Python 3.10+, FastAPI, Uvicorn, SQLite, GitHub Models API (GPT-4o)
Frontend: HTML5, CSS3 (Flexbox, animations, CSS variables), Vanilla JavaScript
Testing: pytest (backend), Selenium + ChromeDriver (UI tests), GitHub Actions (CI/CD)
Deployment: Render (backend), GitHub Pages (frontend), UptimeRobot (monitoring)

The Result

From zero knowledge to a production-ready application with professional development practices. I learned more building this than months of tutorials ever taught me. The project is live, tested, monitored, and ready for users.


Demo: https://xyon15.github.io/os-assistant/
GitHub: https://github.com/Xyon15/os-assistant
Release: https://github.com/Xyon15/os-assistant/releases/tag/v1.0.0-stable
License: GPL v3
Version: 1.0.0

Attachment
2

Comments

Foxreef
Foxreef 20 days ago

“Complete AI assistant from scratch”
Looks inside: ChatGPT wrapper

Xyon
Xyon 18 days ago

To clarify, the “from scratch” part refers to building the entire assistant system myself: backend architecture, frontend, API design, testing, CI/CD, deployment, and monitoring.

For the AI capabilities, the project currently relies on GPT-4o via GitHub Models, which is a deliberate choice for this stage of development in order to focus on shipping a stable, production-ready application and learning professional workflows.

A longer-term goal of the project is to experiment with custom or fine-tuned models trained for specific use cases, but that is outside the scope of the current version.