Install Zep
Zep ships two ways. Pick whichever fits.
For most people: download the app
- Download
Zep.dmgfrom the latest release. - Open the DMG and drag Zep to your Applications folder.
- Double-click Zep. It’ll open a tab in your browser and put a lightning-bolt icon in your menu bar.
The first launch opens a setup flow that walks you through connecting Slack, GitLab, and Airflow.
For developers: Homebrew
brew tap Zenku-App/zepbrew install zepzepzep binds 127.0.0.1:8550, opens the UI in your browser, and runs a menu-bar icon. Data lives in ~/.zep/.
Flags
| Flag | What it does |
|---|---|
--no-tray | Skip the menu bar icon (still opens the browser) |
--port <n> | Bind a different port (default 8550) |
--data-dir <path> | Use a different data directory (default ~/.zep/) |
Environment variables:
ZEP_NO_BROWSER=1suppresses the auto-open. Useful forsystemd-style supervision.
Next
- Connect your tools — Slack, GitLab, Airflow setup
- Troubleshooting — if something looks wrong