Skip to content

windows-setup.md

Latest commit

 

History

History
84 lines (53 loc) · 1.92 KB

windows-setup.md

File metadata and controls

84 lines (53 loc) · 1.92 KB
Raw

Windows Setup Guide for Ragtime

This guide covers installation on Windows using Git Bash.

Prerequisites

  • Windows 10/11 (64-bit)
  • Git for Windows (includes Git Bash) — Download
  • Internet connection (for downloading tools and dependencies)

Installation

Open Git Bash and run:

curl -fsSL https://raw.githubusercontent.com/etalab-ia/ragtime/main/install.sh | bash

This installs uv, just, and the ragtime CLI as a global tool.

Then restart Git Bash (or run the source command shown by the installer) so the new tools are available on your PATH.

Create your project

ragtime setup mon-projet
cd mon-projet && just run

Troubleshooting

curl not found

Make sure you are using Git Bash, not Command Prompt or PowerShell. Git Bash includes curl by default.

ragtime command not found after install

Restart Git Bash so the updated PATH takes effect, then verify:

ragtime --version

If still not found, add ~/.local/bin to your PATH manually:

export PATH="$HOME/.local/bin:$PATH"

Add this line to ~/.bashrc to make it permanent.

Git Not Found

Ensure Git for Windows is installed and available:

git --version

If not found, download and install from git-scm.com.

Behind a Corporate Proxy

Set proxy environment variables before running the installer:

export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080
curl -fsSL https://raw.githubusercontent.com/etalab-ia/ragtime/main/install.sh | bash

For more details, see Proxy Setup Guide.

Next Steps

  1. Read the main README: ../../README.md
  2. Explore available tasks: 
    cd mon-projet && just

Still stuck? Open an issue: https://github.com/etalab-ia/ragtime/issues