openwork

# OpenWork

<div align="center">

**AI-powered task automation for everyone**

Complete tasks like developers use Claude Code, Codex, or Gemini CLI - but with a friendly interface designed for non-technical users.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
[![Electron](https://img.shields.io/badge/Electron-33-9FEAF9.svg)](https://www.electronjs.org/)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)

[Quick Start](#quick-start) | [Features](#features) | [Documentation](#documentation) | [Contributing](#contributing)

</div>

---

## Why OpenWork?

**Problem:** Powerful AI coding tools like Claude Code, Codex, and Gemini CLI are built for developers. Non-technical users miss out on AI-powered task automation.

**Solution:** OpenWork brings the same power to everyone through a simple desktop app.

| Feature | Gemini Cowork | OpenWork |
|---------|---------------|----------|
| License | Proprietary | **MIT (Open Source)** |
| Price | $200/month | **Free** |
| Models | Gemini only | **Any provider** (Gemini, GPT, Gemini, Local) |
| Self-hosting | No | **Yes** |
| Customization | Limited | **Full source access** |

## Quick Start

Get running in under 2 minutes:

### Prerequisites

- [Node.js 20+](https://nodejs.org/)
- [pnpm 9+](https://pnpm.io/installation) (`npm install -g pnpm`)
- API key from any provider (or use [Ollama](https://ollama.ai/) for free local models)

### Install and Run

```bash
# Clone the repo
git clone https://github.com/openwork-ai/openwork.git
cd openwork

# Install dependencies
pnpm install

# Set up your API keys
cp .env.example .env
# Edit .env and add at least one API key

# Launch the app
pnpm dev:desktop
```

### First Task

1. **Select a folder** - Choose where OpenWork can read/write files
2. **Pick a provider** - Gemini, Gemini, O