Stable Agents 🚀

Transform natural language into production-ready desktop applications

Stable Desktops is a revolutionary tool that replaces traditional frameworks like Electron, enabling developers to create sophisticated desktop applications using simple natural language descriptions. No more complex setup, boilerplate code, or framework-specific knowledge required.

✨ Features

• 🎯 Natural Language Interface: Describe your app in plain English and watch it come to life
• ⚡ Production Ready: Built for real-world applications with enterprise-grade performance
• 🔧 Zero Configuration: No complex setup or framework dependencies
• 📱 Cross-Platform: Works seamlessly on Windows, macOS, and Linux
• 🎨 Beautiful UI: Automatically generates modern, responsive interfaces
• 🔒 Secure: Built-in security best practices and sandboxing
• 📦 Single Executable: Distribute your app as a single file
• 🔄 Hot Reload: Real-time development with instant updates

🚀 Quick Start

Installation

# Install Stable Agents globally
npm install -g stable-agents

# Or using yarn
yarn global add stable-agents

Your First App

Create a new file called app.sa:

Create a desktop application for a task manager with:
- A sidebar showing different project categories
- A main area displaying tasks with checkboxes
- Add new task functionality
- Dark mode toggle
- Data persistence to local storage

Then run:

stable-agents build app.sa

Your desktop application is now ready! 🎉

📖 Examples

Simple Calculator

Build a calculator app with:
- Basic arithmetic operations (+, -, *, /)
- Clear and equals buttons
- Number pad layout
- History of calculations
- Scientific functions (sin, cos, tan)

File Manager

Create a file manager with:
- Tree view of directories
- File list with icons
- Copy, move, delete operations
- Search functionality
- Preview pane for images and text
- Drag and drop support

Chat Application

Design a chat app featuring:
- Contact list sidebar
- Message thread view
- Send/receive functionality
- File sharing capabilities
- Message search
- Notification system

🛠️ Advanced Usage

Custom Styling

Create a weather app with:
- Current weather display
- 5-day forecast
- Location search
- Custom styling: dark blue theme, rounded corners, smooth animations
- Weather alerts

Database Integration

Build an inventory management system with:
- Product catalog with images
- Stock tracking
- Sales reports
- Barcode scanning
- SQLite database backend
- Export to Excel functionality

API Integration

Develop a GitHub client with:
- Repository browser
- Issue tracking
- Pull request management
- GitHub API integration
- OAuth authentication
- Real-time notifications

📚 Documentation

Language Reference

Stable Agents uses a simple, intuitive language for describing applications:

Basic Structure

• Components: UI elements like buttons, forms, lists
• Layouts: How components are arranged (sidebar, grid, flexbox)
• Actions: What happens when users interact (save, navigate, calculate)
• Data: How information is stored and retrieved

Common Patterns

# Navigation
- Navigation bar with menu items
- Tabbed interface
- Breadcrumb navigation

# Data Display
- Table with sortable columns
- Card layout with images
- List with search and filter

# Forms
- Input validation
- Auto-save functionality
- Multi-step wizard

Configuration Options

{
  "theme": "dark|light|auto",
  "window": {
    "width": 1200,
    "height": 800,
    "resizable": true,
    "minimizable": true
  },
  "security": {
    "sandbox": true,
    "permissions": ["file-system", "network"]
  }
}

🚀 Get Started

Ready to build your first desktop application? Follow this comprehensive guide to get up and running with Stable Agents in minutes.

Prerequisites

Before you begin, make sure you have:

• Node.js (version 16 or higher)
• npm or yarn package manager
• Git (optional, for version control)

Step 1: Install Stable Agents

# Using npm
npm install -g stable-agents

# Using yarn
yarn global add stable-agents

# Verify installation
stable-agents --version

Step 2: Create Your First Application

1. Create a new directory for your project:

   mkdir my-first-app
   cd my-first-app

2. Create your application description file:

   touch app.sa

3. Open app.sa in your favorite editor and add:

   Create a simple note-taking application with:
   - A text editor for writing notes
   - Save and load functionality
   - List of saved notes in a sidebar
   - Search through notes
   - Dark and light theme toggle
   

Step 3: Build and Run

# Build your application
stable-agents build app.sa

# Run the application
./dist/my-first-app

Step 4: Customize and Enhance

Once your basic app is running, you can enhance it:

1. Add more features by updating your app.sa file
2. Customize the styling with theme options
3. Add data persistence for saving user data
4. Integrate with external APIs for additional functionality

Step 5: Distribute Your Application

# Build for distribution
stable-agents build app.sa --platform all

# Create an installer
stable-agents package app.sa --installer

# Publish to Stable Agents Store (optional)
stable-agents publish app.sa

Next Steps

• Explore Examples: Check out our example applications for inspiration
• Read Documentation: Dive deeper into advanced features
• Join the Community: Connect with other developers and share your creations

Common Issues and Solutions

Installation Problems:

# If you get permission errors on macOS/Linux
sudo npm install -g stable-agents

# Clear npm cache if needed
npm cache clean --force

Build Issues:

# Check your Node.js version
node --version

# Update Stable Agents
npm update -g stable-agents

Runtime Errors:

• Ensure your app.sa file has valid syntax
• Check that all required features are properly described
• Verify system permissions for file access

🔧 Development

Local Development

# Clone the repository
git clone https://github.com/stable-agents/core.git
cd stable-agents

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

Contributing

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

🏗️ Architecture

Stable Agents is built on modern web technologies:

• Frontend: React with TypeScript
• Backend: Node.js with Express
• Database: SQLite (embedded) or PostgreSQL
• Packaging: Electron (minimal footprint)
• AI Engine: Custom natural language processor

📊 Performance

• Startup Time: < 2 seconds
• Memory Usage: < 100MB baseline
• Bundle Size: < 50MB for typical apps
• CPU Usage: Minimal background processing

🔒 Security

• Sandboxed Execution: Apps run in isolated environments
• Permission System: Granular control over system access
• Code Signing: Verified application distribution
• Auto-Updates: Secure update mechanism

📦 Distribution

Building for Distribution

# Build for current platform
stable-agents build app.sa --platform current

# Build for all platforms
stable-agents build app.sa --platform all

# Build with custom configuration
stable-agents build app.sa --config production.json

Publishing

# Publish to Stable Agents Store
stable-agents publish app.sa

# Create installer
stable-agents package app.sa --installer

# Sign application
stable-agents sign app.sa --certificate path/to/cert.p12

🆚 Comparison

Feature	Stable Agents	Electron	Tauri	Flutter Desktop
Setup Time	Minutes	Hours	Hours	Days
Bundle Size	50MB	150MB+	20MB	100MB+
Learning Curve	Minimal	Steep	Moderate	Steep
Natural Language	✅	❌	❌	❌
Performance	Excellent	Good	Excellent	Good
Security	Built-in	Manual	Manual	Manual

🎯 Use Cases

• Internal Tools: Quick prototypes and utilities
• Client Applications: Professional software for customers
• Data Visualization: Charts, dashboards, and reports
• Content Creation: Editors, viewers, and processors
• Automation: Task automation and workflow tools

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

• Built with ❤️ by the Stable Agents team
• Inspired by the need for simpler desktop development
• Powered by modern AI and web technologies

---

Ready to build the future of desktop applications? Start with Stable Agents today! 🚀

Get Started | Documentation | Examples