Metadata-Version: 2.3
Name: portal-os
Version: 1.0.8
Summary: AI-Native Developer Operating System based on Ubuntu
License: MIT
Keywords: operating-system,ai,ubuntu,developer,linux
Author: Portal OS Team
Author-email: team@portal-os.dev
Requires-Python: >=3.8
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: System :: Operating System
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: SpeechRecognition (>=3.10.0)
Requires-Dist: click (>=8.1.7)
Requires-Dist: meilisearch (>=0.20.0)
Requires-Dist: psutil (>=5.9.6)
Requires-Dist: pyttsx3 (>=2.90)
Requires-Dist: requests (>=2.31.0)
Project-URL: Bug Tracker, https://github.com/your-org/portal-os/issues
Project-URL: Changelog, https://github.com/your-org/portal-os/blob/main/CHANGELOG.md
Project-URL: Documentation, https://portal-os.dev/docs
Project-URL: Homepage, https://github.com/your-org/portal-os
Project-URL: Repository, https://github.com/your-org/portal-os
Description-Content-Type: text/markdown

# Portal OS - The World's First AI-Native Developer Operating System

[![Portal OS](https://img.shields.io/badge/Portal%20OS-Developer%20First-blue?style=for-the-badge&logo=linux)](https://github.com/your-org/portal-os)
[![Ubuntu Based](https://img.shields.io/badge/Ubuntu%20Based-24.04%20LTS-orange?style=for-the-badge&logo=ubuntu)](https://ubuntu.com/)
[![AI Native](https://img.shields.io/badge/AI%20Native-Ollama%20%7C%20Gemini-green?style=for-the-badge&logo=robot)](https://ollama.ai/)

> **Portal OS** is a revolutionary operating system that combines Ubuntu's stability with AI-first design principles, inspired by the OS1 from "Her" and the clean aesthetics of Cutefish OS. Built specifically for developers with zero setup time and intelligent automation.

## 🚀 What Makes Portal OS Revolutionary?

### 🎯 **First True Developer OS**
- **Zero Setup**: Everything a developer needs is pre-configured
- **AI-Native**: AI is not an add-on, it's core to the experience
- **Intelligent**: Learns and adapts to individual workflows
- **Productive**: Eliminates time wasted on tool setup and configuration

### 🤖 **AI-First Design**
- **System-wide AI Assistant**: Accessible via hotkey or voice
- **Context-Aware Suggestions**: Based on current activity and history
- **Intelligent Automation**: Automate repetitive tasks
- **Natural Language Interface**: Control system with natural language
- **Predictive Features**: Anticipate user needs

### 🎨 **Beautiful & Customizable**
- **Multi-Theme System**: Mac-like, Windows-like, Cutefish default, clean interfaces
- **Multi-Profile System**: Coding, studying, watching, gaming profiles
- **Seamless Switching**: Instant theme and profile switching
- **Clean Aesthetics**: Minimalist UI inspired by Cutefish OS and OS1 from "Her"

## 🛠️ Core Features

### 💻 **Developer-First Experience**
- **Pre-Loaded Development Stack**: All major languages and tools
- **SDK Managers**: NVM, pyenv, rustup, SDKMAN!, and more
- **AI-Integrated Terminal**: Error analysis, interactive solutions, command suggestions
- **Smart Project Management**: One-command project creation
- **Database Integration**: PostgreSQL, MongoDB, Redis, MySQL with SDKs

### 🔍 **Intelligent Search Assistant**
- **Spotlight Alternative**: Modern, open-source search with AI integration
- **Global Hotkey**: Cmd+Space (or Ctrl+Space) to launch
- **Natural Language Queries**: "Show me my Python projects"
- **Developer Integration**: Git repos, Docker containers, IDE projects
- **Real-time Indexing**: Files indexed as they change

### 🎭 **Multi-Profile System**
- **Coding Profile**: Dark themes, developer tools, performance mode
- **Studying Profile**: Minimal interface, distraction-free, reading optimized
- **Watching Profile**: Dark mode, media optimized, entertainment focused
- **Gaming Profile**: Performance mode, gaming tools, Windows-like interface

### 🔧 **Plugin Architecture**
- **Ubuntu Foundation**: Ubuntu handles core OS maintenance
- **Modular Design**: All customizations are independent plugins
- **Easy Updates**: Apply plugins to any Ubuntu version
- **Zorin OS Inspired**: Plugin-based approach for seamless upgrades

## 📋 System Requirements

### Minimum Requirements
- **OS**: Ubuntu 24.04 LTS or later
- **CPU**: 4 cores, 2.0 GHz or higher
- **RAM**: 8 GB (16 GB recommended)
- **Storage**: 50 GB available space
- **Graphics**: OpenGL 3.3 compatible

### Recommended Requirements
- **CPU**: 8 cores, 3.0 GHz or higher
- **RAM**: 16 GB or more
- **Storage**: 100 GB SSD
- **Graphics**: Dedicated GPU for AI workloads
- **Network**: Stable internet connection for AI services

## 🚀 Quick Start

### Option 1: Live USB Installation
```bash
# Download Portal OS ISO
wget https://portal-os.com/downloads/portal-os-latest.iso

# Create bootable USB
sudo dd if=portal-os-latest.iso of=/dev/sdX bs=4M status=progress
```

### Option 2: Plugin Installation on Ubuntu
```bash
# Add Portal OS repository
sudo add-apt-repository ppa:portal-os/stable
sudo apt update

# Install Portal OS plugins
sudo apt install portal-os-core portal-os-ai portal-os-developer
```

### Option 3: Python Package Installation
```bash
# Install Portal OS as a Python package
pip install portal-os

# Install all components gracefully
portal-os install

# Check component status
portal-os components

# Show system status
portal-os status
```

### Option 4: Development Setup
```bash
# Clone the repository
git clone https://github.com/your-org/portal-os.git
cd portal-os

# Install in development mode
pip install -e .

# Run setup script
./scripts/setup-dev-environment.sh
```

## 📚 Documentation

### 📖 **Start Here**
- **[Getting Started Guide](docs/getting-started.md)** - Step-by-step setup instructions
- **[Minimal OS Summary](docs/MINIMAL-OS-SUMMARY.md)** - Quick overview of core concepts
- **[README Minimal](docs/README-minimal.md)** - Essential information and quick start

### 🎯 **Core Implementation**
- **[Developer-First OS Design](docs/developer-first-os.md)** - Comprehensive developer experience guide
- **[Developer Implementation Guide](docs/developer-implementation.md)** - Technical implementation details
- **[AI Terminal Implementation](docs/ai-terminal-implementation.md)** - AI integration for terminal

### 🎨 **UI/UX and Themes**
- **[Theme System Implementation](docs/theme-system-implementation.md)** - Multi-theme and profile system
- **[Search Assistant Implementation](docs/search-assistant-implementation.md)** - Spotlight alternative

### 🔒 **Privacy and Security**
- **[Privacy Mode Implementation](docs/privacy-mode-implementation.md)** - Privacy and security features
- **[Privacy README](docs/PRIVACY-README.md)** - Privacy policy and data handling

### 🌟 **Vision and Features**
- **[Revolutionary Features](docs/revolutionary-features.md)** - What makes Portal OS revolutionary
- **[Complete Development Plan](docs/plan.md)** - Comprehensive project roadmap

## 🏗️ Architecture

### 🏛️ **Object-Oriented Design**
Portal OS uses a modular, object-oriented architecture with reusable components:

```
Portal OS Architecture
├── Core Framework (portal_os.core)
│   ├── BaseComponent - Abstract base class for all components
│   ├── DatabaseMixin - SQLite database operations
│   ├── ProgressMixin - Progress indicators and logging
│   ├── ConfigMixin - Configuration management
│   ├── SDKManager - Development tools installation
│   └── ComponentInstaller - Graceful component management
├── Components (portal_os.scripts)
│   ├── AI Assistant - Conversational AI with context
│   ├── Security & Privacy - Advanced security management
│   ├── Performance Optimizer - System optimization
│   ├── Search Assistant - Intelligent file search
│   ├── Voice Interaction - Speech-to-text capabilities
│   ├── Advanced AI - AI-powered workspace management
│   ├── Theme Manager - Visual theme management
│   ├── Plugin Manager - Plugin system management
│   └── UI/UX Manager - Interface management
├── Configuration (portal_os.config)
│   ├── Centralized configuration system
│   ├── Profile management
│   └── Component-specific settings
└── CLI Interface (portal_os.cli)
    ├── Unified command-line interface
    ├── Graceful installation handling
    └── Component status monitoring
```

### 🔄 **Graceful Installation**
- **Component Detection**: Automatically detects existing installations
- **Dependency Management**: Handles tool dependencies intelligently
- **Error Recovery**: Continues installation even if some components fail
- **Progress Tracking**: Real-time progress indicators with emojis
- **Logging**: Comprehensive logging for troubleshooting

## 🤝 Contributing

We welcome contributions from the community! Here's how you can help:

### 🐛 **Report Issues**
- Use our [Issue Tracker](https://github.com/your-org/portal-os/issues)
- Provide detailed bug reports with system information
- Include steps to reproduce the issue

### 💡 **Feature Requests**
- Submit feature requests through [GitHub Issues](https://github.com/your-org/portal-os/issues)
- Discuss ideas in our [Community Forum](https://community.portal-os.com)

### 🔧 **Development**
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request

### 📝 **Documentation**
- Help improve our documentation
- Translate documentation to other languages
- Create tutorials and guides

## 📄 License

Portal OS is licensed under the **GNU General Public License v3.0** - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- **Ubuntu** - For providing the stable foundation
- **Cutefish OS** - For inspiring the clean aesthetic design
- **Ollama** - For local AI model support
- **Meilisearch** - For the fast search engine
- **Tauri** - For the modern desktop app framework
- **Open Source Community** - For all the amazing tools and libraries

## 📞 Support

### 🆘 **Getting Help**
- **[Documentation](docs/)** - Comprehensive guides and tutorials
- **[Community Forum](https://community.portal-os.com)** - Ask questions and share experiences
- **[Discord Server](https://discord.gg/portal-os)** - Real-time chat and support
- **[GitHub Issues](https://github.com/your-org/portal-os/issues)** - Bug reports and feature requests

### 📧 **Contact**
- **Email**: support@portal-os.com
- **Twitter**: [@PortalOS](https://twitter.com/PortalOS)
- **Reddit**: [r/PortalOS](https://reddit.com/r/PortalOS)

## 🌟 Star History

[![Star History Chart](https://api.star-history.com/svg?repos=your-org/portal-os&type=Date)](https://star-history.com/#your-org/portal-os&Date)

---

**Portal OS** - Where AI meets productivity, and developers finally get the OS they deserve. 🚀

*Built with ❤️ by the Portal OS community*

