AI-Native Developer Operating System based on Ubuntu
Project description
Portal OS - The World's First AI-Native Developer Operating System
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
# 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
# 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: Development Setup
# Clone the repository
git clone https://github.com/your-org/portal-os.git
cd portal-os
# Run setup script
./scripts/setup-dev-environment.sh
๐ Documentation
๐ Start Here
- Getting Started Guide - Step-by-step setup instructions
- Minimal OS Summary - Quick overview of core concepts
- README Minimal - Essential information and quick start
๐ฏ Core Implementation
- Developer-First OS Design - Comprehensive developer experience guide
- Developer Implementation Guide - Technical implementation details
- AI Terminal Implementation - AI integration for terminal
๐จ UI/UX and Themes
- Theme System Implementation - Multi-theme and profile system
- Search Assistant Implementation - Spotlight alternative
๐ Privacy and Security
- Privacy Mode Implementation - Privacy and security features
- Privacy README - Privacy policy and data handling
๐ Vision and Features
- Revolutionary Features - What makes Portal OS revolutionary
- Complete Development Plan - Comprehensive project roadmap
๐๏ธ Architecture
Portal OS Architecture
โโโ Ubuntu LTS (Foundation)
โโโ Plugin System
โ โโโ AI Integration Plugins
โ โโโ Developer Experience Plugins
โ โโโ UI/UX Plugins
โ โโโ System Enhancement Plugins
โโโ AI Backend (Ollama/LM Studio/Gemini)
โโโ Theme System (Multi-Theme/Profile)
โโโ Search Assistant (Meilisearch + Tauri)
๐ค Contributing
We welcome contributions from the community! Here's how you can help:
๐ Report Issues
- Use our Issue Tracker
- Provide detailed bug reports with system information
- Include steps to reproduce the issue
๐ก Feature Requests
- Submit feature requests through GitHub Issues
- Discuss ideas in our Community Forum
๐ง 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 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 - Comprehensive guides and tutorials
- Community Forum - Ask questions and share experiences
- Discord Server - Real-time chat and support
- GitHub Issues - Bug reports and feature requests
๐ง Contact
- Email: support@portal-os.com
- Twitter: @PortalOS
- Reddit: r/PortalOS
๐ Star History
Portal OS - Where AI meets productivity, and developers finally get the OS they deserve. ๐
Built with โค๏ธ by the Portal OS community
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file portal_os-1.0.3.tar.gz.
File metadata
- Download URL: portal_os-1.0.3.tar.gz
- Upload date:
- Size: 126.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/2.1.4 CPython/3.12.7 Windows/11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8d5c40f8d7d0b217a251ea3dac22215e236ff96c1aadab8e0a4e96ae101c0c69
|
|
| MD5 |
f7b4194601217db412656f355b95c3e4
|
|
| BLAKE2b-256 |
6e953349cba9cc8ee41155b5104e35aaec2f49a6adc188c9453827c80bb3c742
|
File details
Details for the file portal_os-1.0.3-py3-none-any.whl.
File metadata
- Download URL: portal_os-1.0.3-py3-none-any.whl
- Upload date:
- Size: 37.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/2.1.4 CPython/3.12.7 Windows/11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d7c76074f640654d82ea9f6ade90bf88fad8bb24a4d3256dbb4ad25c5cfef215
|
|
| MD5 |
7e7ce58f544c9acff8cfc99d262e7108
|
|
| BLAKE2b-256 |
2c91146d3f74fa34f462f790e840fb00a66abcdf6841de552928fb9bc861d538
|