🚀 Release v0.1.0

📝 Overview

This inaugural release of Archon Beta marks a major milestone as a comprehensive AI knowledge management system designed for local deployment. Built from the ground up with modern technologies, Archon serves as an operating system for AI coding assistants, featuring advanced RAG capabilities, project management, and seamless IDE integration through MCP (Model Context Protocol).

✨ What's New

Major Features

Knowledge Management System - Advanced RAG (Retrieval-Augmented Generation) with semantic search, web crawling, and document upload capabilities
Project Management - Full project lifecycle management with tasks, documents, and version control
MCP Server Integration - Native support for Claude Code, Cursor, Windsurf, and other AI IDEs through Model Context Protocol
Multi-LLM Provider Support - Support for OpenAI, Anthropic, OpenRouter, Grok, Gemini, and Ollama with configurable models
Real-time Progress Tracking - Live monitoring of crawling operations and long-running tasks
Document Browser - Comprehensive document management with domain filtering and full-text search
Modern React UI - Glassmorphism design with TanStack Query v5 for optimal performance

Improvements

Hybrid Search Strategy - Enhanced search combining vector embeddings with keyword matching using tsvector
Smart Polling Architecture - Visibility-aware HTTP polling replacing WebSocket connections for better reliability
Optimistic Updates - Instant UI feedback with UUID-based stable identifiers
ETag Caching - Browser-native HTTP caching for 70% bandwidth reduction
Vertical Slice Architecture - Feature-based organization for better maintainability
Comprehensive Error Handling - Provider-agnostic error handling across all LLM providers
Docker Compose Profiles - Flexible development environment with hybrid and full-docker modes

Bug Fixes

Database Timeout Resolution - Fixed timeout issues when deleting large knowledge sources
Crawler Stability - Resolved memory crashes and timeout issues for JavaScript-heavy documentation sites
URL Resolution - Fixed sitemap URL detection and recursive crawling edge cases
Task Priority Decoupling - Separated task priority from display order for better UX
Provider Configuration - Fixed Ollama default URL for Docker compatibility
Type Safety - Resolved TypeScript strict mode errors across the codebase

🔧 Technical Changes

Backend (Python/FastAPI)

FastAPI Server - High-performance async API with comprehensive service layer pattern
Supabase Integration - PostgreSQL with pgvector for advanced vector operations
PydanticAI Agents - Specialized AI agents for document processing and code analysis
Async Architecture - Full async/await implementation for optimal performance
Rate Limiting Protection - Intelligent handling of LLM provider rate limits
Service Layer Pattern - Clean separation between API routes, business logic, and data access

Frontend (React/TypeScript)

TanStack Query v5 - Complete migration to modern data fetching with smart caching
Tailwind CSS 4 - Latest styling framework with custom glassmorphism theme
Biome + ESLint - Dual linting setup for legacy and modern code patterns
Vite Build System - Fast development and optimized production builds
Feature-based Architecture - Vertical slices with self-contained features
Accessibility Improvements - ARIA attributes and keyboard navigation support

Infrastructure

Multi-service Docker Setup - Separate containers for server, MCP, agents, and frontend
Development Profiles - Hybrid development with backend in Docker, frontend local
CI/CD Pipeline - Automated testing and linting with GitHub Actions
Package Management - UV for Python dependencies, npm for frontend
Health Checks - Comprehensive service monitoring and status endpoints

📊 Statistics

Commits: 245
Pull Requests: 0 (initial release)
Files Changed: 500+ across frontend, backend, and documentation
Contributors: 15

🙏 Contributors

Thanks to everyone who contributed to this release:
@cole Medin @sean-eskerium @Wirasm @diy Smart Code @josh @jonah Gray @john Fitzpatrick @leex279 @rasmus Widing @daniel Jankowski @michael Hines @siparker @nadjib Boubrim @tim Carter @Arman Rafiee @sanath Kumar U @thilanga Pitigala @eric Fisher @takshit12 @cannuri @aniket @hong @Michaelzag @Aniket1995 @edilson Lima @BarelElbaz @juan Miguel @xactant

📚 Documentation

Comprehensive README - Detailed installation and usage instructions
Contributing Guidelines - Clear guidelines for contributors
MCP Integration Docs - Step-by-step setup for AI IDEs
Architecture Documentation - Technical deep-dive into system design
Claude Code Instructions - Specialized commands and agents for Claude Code
Development Setup - Docker Compose profiles and hybrid development workflows

⚠️ Breaking Changes

Complete rewrite - This is a ground-up rebuild from previous Archon versions
New database schema - Fresh Supabase setup required
Configuration changes - New environment variable structure
API endpoints - RESTful API replacing previous patterns
Project structure - Monorepo with separate frontend/backend directories