# Public endpoint (no auth required)
curl http://localhost:9123/threads

# Protected endpoint (requires API key)
curl -H "X-API-Key: your_api_key_here" \
    http://localhost:9123/health

I'm excited to announce the release of Let's Talk 0.1.5, a significant milestone that transforms this AI-powered interactive chat component into a production-ready, self-hostable solution. This release introduces comprehensive self-hosting capabilities, enhanced security features, and a completely refactored architecture that makes deployment and maintenance significantly easier.

Contents

What's New in 0.1.5

Let's Talk 0.1.5 represents a major evolution from a development prototype to a production-ready system. Here are the key highlights:

🏗️ Production-Ready Infrastructure

• Comprehensive entrypoint system with standalone startup scripts
• First-time execution detection and automated setup processes
• Database existence checks and automatic creation logic
• System health monitoring with detailed startup banners
• Comprehensive database migration system using Alembic

🔒 Enhanced Security

• API access control with nginx proxy and dynamic key loading
• CORS support for LangGraph API with proper configuration
• Database URL sanitization to prevent sensitive information exposure
• Enhanced security schemes in OpenAPI documentation

🐳 Self-Hosting Excellence

• Docker Compose architecture with microservices design
• Pre-built GitHub Container Registry images for easy deployment
• Comprehensive environment configuration with production templates
• Backup and recovery systems for data protection

🧩 Modular Architecture

• Refactored codebase with improved import paths and organization
• Custom exceptions and utility tools for better error handling
• Performance monitoring and optimization services
• Vector store management capabilities

Breaking Changes and Migration

Important: This release includes breaking changes that require migration:

Directory Structure Changes

• py-src folder renamed to backend for better organization
• Updated import paths throughout the codebase
• Configuration files relocated to reflect new structure

Dependency Updates

• Removed Chainlit dependencies for improved maintainability
• Migrated from legacy test files to pytest framework
• Updated frontend components for Svelte 5 compatibility

Enhanced Self-Hosting Experience

The crown jewel of this release is the comprehensive self-hosting guide and infrastructure. Let's Talk now provides everything you need to deploy a production-ready AI chat system.

Quick Start with Docker Compose

Getting started is now incredibly simple:

# Clone the repository
git clone https://github.com/mafzaal/lets-talk.git
cd lets-talk

# Make startup script executable
chmod +x start-docker.sh

# Configure environment
cp .env.example .env.prod
# Edit .env.prod with your settings

# Launch all services
./start-docker.sh

Microservices Architecture

The new architecture includes five core services:

• PostgreSQL: Primary database for content and metadata
• Redis: Cache and session storage
• Qdrant: Vector database for semantic search
• Let's Talk API: Main application service
• Nginx Proxy: Load balancing, SSL termination, and rate limiting

Pre-built Container Images

You can now use pre-built images from GitHub Container Registry:

api:
  image: ghcr.io/mafzaal/lets-talk:latest
  # No need to build from source

Security and Production Features

Security was a major focus in this release, with several enterprise-grade features:

API Authentication

• Dynamic API key loading from secure environment files
• Rate limiting: 30 requests/minute for public endpoints, 100 for authenticated
• Protected and public endpoint separation

Example Authentication Usage

# Public endpoint (no auth required)
curl http://localhost:9123/threads

# Protected endpoint (requires API key)
curl -H "X-API-Key: your_api_key_here" \
     http://localhost:9123/health

SSL/TLS Support

The nginx proxy is configured for SSL termination with modern security standards:

ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384;

Modular Architecture Improvements

The codebase has been completely refactored for maintainability and scalability:

Enhanced Component Organization

• Modular import paths for better dependency management
• Custom exception handling throughout the system
• Performance monitoring services with detailed metrics
• Vector store management with backup capabilities

Testing Infrastructure

• Comprehensive test suites for all components
• Pytest framework migration from legacy testing
• Component-specific test coverage for reliability

Pipeline Processing

• Semantic chunking configuration and implementation
• ChunkingStrategy enum for flexible content processing
• Incremental fallback thresholds for document processing
• Enhanced API documentation with detailed descriptions

Getting Started with Self-Hosting

System Requirements

Environment Configuration

The new environment system supports multiple configuration files:

• .env.prod: Main production configuration
• .env.auth: API authentication keys
• .env.pipeline: Advanced content processing settings

Health Monitoring

Built-in health checks and monitoring:

# Check service status
docker compose ps

# Monitor resource usage
docker stats

# View aggregated logs
docker compose logs -f --tail=100

Migration Guide

For existing users, here's what you need to know:

Pre-Migration Checklist

1. Backup your data and configuration files
2. Review breaking changes in the changelog
3. Update Docker and Docker Compose to supported versions
4. Plan for downtime during the migration process

Key Migration Steps

1. Update repository structure to use new backend directory
2. Migrate configuration files to new format
3. Update import statements in custom integrations
4. Test authentication systems with new API key format

What's Next

Let's Talk 0.1.5 establishes a solid foundation for future development. Upcoming features include:

• Kubernetes deployment manifests for enterprise environments
• Multi-tenant support for serving multiple organizations
• Advanced analytics and usage metrics
• Plugin architecture for custom extensions
• WebSocket support for real-time interactions

Resources and Documentation

• Complete Self-Hosting Guide: Comprehensive deployment documentation
• Changelog: Detailed release notes and breaking changes
• GitHub Repository: Source code and issue tracking
• Container Registry: Pre-built Docker images

Let's Talk 0.1.5 represents a major step forward in making AI-powered interactive chat accessible to everyone. Whether you're running a personal blog or deploying enterprise content systems, this release provides the tools and infrastructure you need for success.

Try the new self-hosting capabilities today and join our growing community of developers building the future of interactive content experiences!