Fetch ML - Secure Machine Learning Platform

A secure, containerized platform for running machine learning experiments with role-based access control and comprehensive audit trails.

Quick Start

New to the project? Start here!

# Clone the repository
git clone https://github.com/your-username/fetch_ml.git
cd fetch_ml

# Quick setup (builds everything, creates test user)
make quick-start

# Create your API key
./bin/user_manager --config configs/config_dev.yaml --cmd generate-key --username your_name --role data_scientist

# Run your first experiment
./bin/worker --config configs/config_dev.yaml --api-key YOUR_GENERATED_KEY

Quick Navigation

🚀 Getting Started

• Getting Started Guide - Complete setup instructions
• Simple Install - Quick installation guide

🔒 Security & Authentication

• Security Overview - Security best practices
• API Key Process - Generate and manage API keys
• User Permissions - Role-based access control

⚙️ Configuration

• Environment Variables - Configuration options
• Smart Defaults - Default configuration settings

🛠️ Development

• Architecture - System architecture and design
• CLI Reference - Command-line interface documentation
• Testing Guide - Testing procedures and guidelines
• Queue System - Job queue implementation

🏭 Production Deployment

• Deployment Guide - Production deployment instructions
• Production Monitoring - Monitoring and observability
• Operations Guide - Production operations

Features

• 🔐 Secure Authentication - RBAC with API keys, roles, and permissions
• 🐳 Containerized - Podman-based secure execution environments
• 🗄️ Database Storage - SQLite backend for user management (optional)
• 📋 Audit Trail - Complete logging of all actions
• 🚀 Production Ready - Security audits, systemd services, log rotation

Available Commands

# Core commands
make help                    # See all available commands
make build                   # Build all binaries
make test-unit              # Run tests

# User management
./bin/user_manager --config configs/config_dev.yaml --cmd generate-key --username new_user --role data_scientist
./bin/user_manager --config configs/config_dev.yaml --cmd list-users

# Run services
./bin/worker --config configs/config_dev.yaml --api-key YOUR_KEY
./bin/tui --config configs/config_dev.yaml
./bin/data_manager --config configs/config_dev.yaml

Need Help?

• 📖 Documentation: Use the navigation menu on the left
• ⚡ Quick help: make help
• 🧪 Tests: make test-unit

---

Happy ML experimenting!