<div align="center"> <img src="docs/logo.png" alt="OpenAsst Logo" width="200"/>

OpenAsst

AI-Powered Terminal Assistant for Natural Language System Operations

<br/>

🌐 Web Dashboard  •  📖 Documentation  •  💬 Issues

<br/> <img src="https://raw.githubusercontent.com/abingyyds/OpenAsst/main/docs/demo.gif" alt="OpenAsst Demo" width="700"/> </div> <br/>

✨ Overview

OpenAsst is an intelligent terminal assistant that lets you manage servers and execute system tasks using natural language.

<table> <tr> <td width="50%">

🖥️ CLI Tool (Core)

A powerful command-line tool for AI-driven system operations

• Natural language task execution
• Multi-server cluster control
• API sharing with dev tools

</td> <td width="50%">

🌐 Web Dashboard

Visual interface at OpenAsst.Ai

• Server management GUI
• Batch AI execution
• Real-time terminal streaming

</td> </tr> </table>

---

🚀 Quick Start

One-Line Installation

<table> <tr> <td><b>macOS / Linux</b></td> <td>

curl -fsSL https://raw.githubusercontent.com/abingyyds/OpenAsst/main/install.sh | bash

</td> </tr> <tr> <td><b>Windows (PowerShell)</b></td> <td>

iwr -useb https://raw.githubusercontent.com/abingyyds/OpenAsst/main/install.ps1 | iex

</td> </tr> </table>

Configure & Use

# Configure your API key
openasst config

# Start using with natural language!
openasst do "install nginx and configure it for port 8080"

---

🎯 CLI Features

| Feature | Description | |:--------|:------------| | 🎛️ Cluster Control | Manage multiple servers simultaneously | | 🤖 Smart Task Engine | Execute any task using natural language | | 🔧 Auto Error Recovery | Intelligent error detection and auto-fixing | | 🔒 Security Guard | Built-in protection against dangerous commands | | 🔗 API Sharing | Share AI API with Claude Code, Cursor, Aider | | 🧩 Skill System | Extensible skills for Git, Docker, System ops | | ⏰ Scheduled Tasks | Create timers and automated jobs | | 🚀 Auto Deployment | Deploy from Git repos or documentation |

---

💡 Smart Task Engine

Execute any task with natural language:

# Install software
openasst do "install docker and start it"

# System operations
openasst do "check disk usage and clean up if over 80%"

# Development tasks
openasst do "create a new React project with TypeScript"

# Auto-confirm mode
openasst do "update all npm packages" -y

---

📦 Deploy from Documentation

# From URL
openasst deploy https://example.com/install-guide.md

# From local file
openasst deploy ./INSTALL.md

# Auto deploy from Git
openasst auto https://github.com/user/repo.git

---

🔗 API Sharing

Share your AI API with other development tools:

openasst api share claude-code   # Claude Code
openasst api share cursor        # Cursor
openasst api share               # All tools

Supported: Claude Code, Cursor, Continue, Aider

---

🎛️ Cluster Control

Manage multiple servers from a single command line.

┌─────────────────────────────────────────────────┐
│              Master (Your Machine)               │
│  ┌──────────┐  ┌──────────┐  ┌──────────────┐  │
│  │ CLI      │  │ WSHub    │  │ DeviceManager│  │
│  └──────────┘  └──────────┘  └──────────────┘  │
└─────────────────────┬───────────────────────────┘
                      │ WebSocket
       ┌──────────────┼──────────────┐
       ▼              ▼              ▼
 ┌──────────┐  ┌──────────┐  ┌──────────┐
 │ Server A │  │ Server B │  │ Server C │
 └──────────┘  └──────────┘  └──────────┘

# Add devices
openasst devices add

# Execute on all servers
openasst run "uname -a" --all

# AI tasks on cluster
openasst do "install nginx" --all

---

🌐 Web Dashboard

Live Demo: OpenAsst.Ai

| Feature | Description | |:--------|:------------| | 🖥️ Server Management | Add and manage multiple SSH servers | | 🎛️ Batch Control | Execute AI tasks on multiple servers | | 🤖 Terminal Agent | Deploy CLI agent on remote servers | | 📜 Script Marketplace | Share and use command templates | | ⚡ Real-time Streaming | Live command output in browser |

---

Self-Hosted Setup

# Clone & Install
git clone https://github.com/abingyyds/OpenAsst.git
cd OpenAsst && npm install
cd frontend && npm install && cd ..

# Configure .env files
cp .env.example .env

# Run
npm run dev          # Backend
cd frontend && npm run dev  # Frontend

---

⚙️ Configuration

CLI: ~/.openasst-cli/config.json

{
  "apiKey": "your-anthropic-api-key",
  "baseUrl": "https://api.anthropic.com",
  "model": "claude-sonnet-4-20250514"
}

---

📁 Project Structure

OpenAsst/
├── cli/                # CLI Tool (Core)
├── src/                # Web Backend
├── frontend/           # Web Dashboard (Next.js)
├── local-agent/        # Local Agent
└── install.sh          # Installer

---

🔒 Security

• Blocks dangerous commands (rm -rf /, mkfs, etc.)
• Warns about sudo operations
• Requires confirmation for destructive actions

---

🤝 Contributing

Contributions welcome! Please submit issues and pull requests.

📄 License

MIT License - see LICENSE

---

<div align="center">

🌐 OpenAsst.Ai  •  ⭐ Star on GitHub

Made with ❤️ by OpenAsst Team

</div>