An AI-first, mobile-first IDE and admin tool, made with love and passion by software engineers, for software engineers.

Portacode transforms any device with python into a remotely accessible development environment. Access your home lab, server or even embedded system chip from your phone, code on your desktop or your smartphone from anywhere, or help a colleague debug their server - all through a beautiful web interface designed for the modern developer.

• 🤖 AI-First: Built from the ground up with AI integration in mind
• 📱 Mobile-First: Code and administrate from your phone or tablet
• 🌍 Global Access: Connect to your devices from anywhere with internet
• 🔐 Secure: HTTPS encrypted with RSA key authentication
• ⚡ Fast Setup: Get connected in under 60 seconds
• 🔄 Always Connected: Automatic reconnection and persistent service options
• 🆓 Free Account: Create your account and start connecting immediately
• 🖥️ Cross-Platform: Works on Windows, macOS, and Linux

pip install portacode

portacode connect

Follow the on-screen instructions to:

• Visit https://portacode.com
• Create your free account
• Add your device using the generated key
• Start coding and administrating!

Once connected, you can:

• Open terminal sessions from the web dashboard
• Execute commands remotely
• Monitor system status
• Access your development environment from any device

• Remote Development: Code, build, and debug from anywhere - even your phone
• Server Administration: 24/7 server access with persistent service installation
• Mobile Development: Full IDE experience on mobile devices

# Start a connection (runs until closed)
portacode connect

# Run connection in background
portacode connect --detach

# Check version
portacode --version

# Get help
portacode --help

# First, authenticate your device
portacode connect

# For system services, install package system-wide
sudo pip install portacode --system

# Install persistent service (auto-start on boot)
sudo portacode service install

# Check service status (use -v for verbose debugging)
sudo portacode service status
sudo portacode service status -v

# Stop/remove the service
sudo portacode service stop
sudo portacode service uninstall

Access your connected devices at https://portacode.com

Current Features:

• Real-time terminal access
• System monitoring
• Device management
• Multi-device switching
• Secure authentication

Coming Soon:

• AI-powered code assistance
• Mobile-optimized IDE interface
• File management and editing
• Collaborative development tools

• RSA Key Authentication: Each device gets a unique RSA key pair
• HTTPS Encrypted: All communication is encrypted in transit
• No Passwords: Key-based authentication eliminates password risks
• Revocable Access: Remove devices instantly from the web dashboard
• Local Key Storage: Private keys never leave your device

# Check if another connection is running
portacode connect

# View service logs
sudo portacode service status --verbose

# First authenticate your device
portacode connect

# If service commands fail, ensure system-wide installation
sudo pip install portacode --system

# Then try service installation again
sudo portacode service install

# Use verbose status to debug connection issues
sudo portacode service status -v

# Install clipboard support
sudo apt-get install xclip

Key files are stored in:

• Linux: ~/.local/share/portacode/keys/
• macOS: ~/Library/Application Support/portacode/keys/
• Windows: %APPDATA%\portacode\keys\

Portacode is a young project with big dreams. We're building the future of remote development and mobile-first coding experiences. As a new project, we're actively seeking:

• 👥 Community Feedback: Does this solve a real problem for you?
• 🤝 Contributors: Help us build the IDE of the future
• 📢 Early Adopters: Try it out and let us know what you think
• 💡 Feature Ideas: What would make your remote development workflow better?

Your support matters! Whether you contribute code, report bugs, share ideas, or simply let us know that you find value in what we're building - every bit of feedback helps us decide whether to continue investing in this vision or focus on other projects.

• Email: hi@menas.pro
• Support: support@portacode.com
• GitHub: https://github.com/portacode/portacode

We welcome all forms of contribution:

• 🐛 Bug Reports: Found something broken? Let us know!
• ✨ Feature Requests: What would make Portacode better for you?
• 📖 Documentation: Help others get started
• 💻 Code Contributions: Help us build the future of remote development
• 💬 Feedback: Tell us if you find this useful!

Check out our GitHub repository to get started.

MIT License - see LICENSE file for details.

Get started today: pip install portacode && portacode connect

Built with ❤️ and ☕ by passionate software engineers