Native installers.
Each installer ships a self-contained binary — no Python, DuckDB, or toolchain required on your machine. Download, run, click the shortcut.
| 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).
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
- Install Python 3.11 or newer. Open the
python.org downloads page
and run the latest macOS 64-bit universal2 installer
(
3.11.xor3.12.x). - Open the Terminal app (⌘+Space →
type
Terminal→ Return) and run:pip install datasus-etl - Pick a tutorial for how you want to use it:
- CLI workflow → — terminal commands, scripts, automation.
- Python library → — import as a module from your own scripts or notebooks.
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 + optionalPATHupdate (HKCU). - macOS →
/Applications/DataSUS ETL.app+ optional symlink in/usr/local/bin/datasus. - Linux → AppImage is self-contained. Run it from anywhere. A
.desktopentry 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.