Installation

Get OpenDraft running on your computer in minutes.

Desktop App (Recommended)

The desktop app is the easiest way to use OpenDraft. Everything is bundled — no setup, no accounts, just install and write.

macOS

  1. Download the .dmg file from the latest release page.
  2. Open the .dmg file and drag OpenDraft into your Applications folder.
  3. Open OpenDraft from your Applications folder. On first launch, macOS may ask you to confirm you want to open an app from an identified developer — click Open.
⚠️

macOS Gatekeeper: If you see "OpenDraft can't be opened because it is from an unidentified developer", go to System Settings > Privacy & Security and click Open Anyway.

Windows

  1. Download the .exe installer (or .msi for enterprise deployment) from the latest release page.
  2. Run the installer and follow the prompts.
  3. OpenDraft will appear in your Start Menu.

Linux

Choose the package format for your distribution:

DistributionFormatInstall command
Ubuntu / Debian .deb sudo dpkg -i OpenDraft_*.deb
Fedora / RHEL .rpm sudo rpm -i OpenDraft-*.rpm
Any (portable) .AppImage chmod +x OpenDraft_*.AppImage && ./OpenDraft_*.AppImage

Mobile Apps

Android

  1. Download the .apk file from the latest release page.
  2. Open the .apk file on your Android device to install.
  3. If prompted, allow installation from unknown sources in your device settings.
ℹ️

Note: The Android app works fully offline using local storage. No backend server is needed — your scripts are stored on-device.

iOS

The iOS app is available on the App Store. Search for "OpenDraft" or visit the app page directly. The iOS app also works fully offline using local storage.

Mac App Store

OpenDraft is also available on the Mac App Store as an alternative to the direct download. Search for "OpenDraft" in the App Store on your Mac.

Run in Browser (Self-Hosted)

If you prefer running OpenDraft in your browser, you can self-host it. This requires some technical setup.

Requirements

One-Line Setup

git clone https://github.com/Proteus-Technologies-Private-Limited/OpenDraft.git
cd OpenDraft
./setup.sh

The script installs all dependencies, builds the app, and opens it in your browser at http://localhost:8000.

Manual Setup

If the setup script doesn't work, or you want more control:

  1. Clone the repository:
    git clone https://github.com/Proteus-Technologies-Private-Limited/OpenDraft.git
    cd OpenDraft
  2. Set up the Python backend:
    python3.12 -m venv venv
    source venv/bin/activate
    pip install -r backend/requirements.txt
  3. Install frontend dependencies:
    cd frontend && npm install && cd ..
  4. Start the backend server (in one terminal):
    ./start_backend.sh
  5. Start the frontend dev server (in another terminal):
    ./start_frontend.sh
  6. Open http://localhost:5173 in your browser.
ℹ️

The development setup uses localhost:5173 (Vite dev server). The production build uses localhost:8000 (served by the Python backend).