datasus-etl
Release v0.1.11

Native installers.

Each installer ships a self-contained binary — no Python, DuckDB, or toolchain required on your machine. Download, run, click the shortcut.

Release v0.1.11
Platform
Windows
64-bit · 10 / 11
Get
macOS (Apple Silicon)
arm64 · 11+
Get
Linux
x86_64 · glibc 2.35+
Get

Released on GitHub: v0.1.11 · all releases. Verify checksums with sha256sum (Linux), shasum -a 256 (macOS), or Get-FileHash (PowerShell).

Intel Mac users

No native installer —
build from source.

We ship a native .dmg only for Macs with Apple Silicon (M-series chips). If your Mac has an Intel processor, follow the steps on the right to install from source — it works, it uses exactly the same code, and takes about five minutes of terminal time. No programming experience required.

Step-by-step

  1. Install Python 3.11 or newer. Open the python.org downloads page and run the latest macOS 64-bit universal2 installer (3.11.x or 3.12.x).
  2. Open the Terminal app (+Space → type Terminal → Return) and run:
    pip install datasus-etl
  3. Pick a tutorial for how you want to use it:
Technical

Package contents

Each installer bundles the same Nuitka-compiled binary — the app you run is the same one across platforms. The installer places the files in the OS-standard location, creates a shortcut to launch datasus ui, and (if you leave the checkbox marked) adds the datasus CLI to your PATH so commands like datasus pipeline work from any terminal.

On install

  • Windows → %ProgramFiles%\DataSUS ETL\ + Start Menu shortcut + optional PATH update (HKCU).
  • macOS → /Applications/DataSUS ETL.app + optional symlink in /usr/local/bin/datasus.
  • Linux → AppImage is self-contained. Run it from anywhere. A .desktop entry registers automatically when you place it in ~/.local/share/applications/.

On first launch

The app starts a local web server on 127.0.0.1:8787 and opens your default browser. The server is loopback-only — nothing is exposed to the network.

User settings

Your data-directory preference and other settings are persisted in ~/.config/datasus-etl/config.toml (Linux/macOS) or the equivalent location under %APPDATA% on Windows.