HedgeBuddy

Cross-platform environment variable management for Python scripts without system pollution.

What is HedgeBuddy?

HedgeBuddy makes Python automation scripts easy to configure for DIT/Data Wrangling workflows using Hedge's software ecosystem (OffShoot, FoolCat, EditReady):

1. Python Library (hedgebuddy) - Simple API for reading variables in scripts
2. Desktop GUI App - Beautiful interface for managing variables (Windows & macOS)

Quick Start

Install

pip install --user hedgebuddy

Download the desktop app from Releases.

Use in Scripts

import hedgebuddy

# Required variable (raises error if not configured)
api_key = hedgebuddy.var("API_KEY")

# Optional variable with fallback
api_url = hedgebuddy.var("API_URL", "https://api.example.com")

# Check if variable exists
if hedgebuddy.exists("PREMIUM_FEATURES"):
    enable_premium()

That's it! No system environment pollution, no complex setup.

Key Features

✅ Zero System Pollution - Variables stored locally, never touch system environment
✅ Cross-Platform - Windows and macOS
✅ Simple API - Just hedgebuddy.var("NAME")
✅ Beautiful GUI - Modern desktop app for variable management
✅ Validation - Built-in path and URL validation

How It Works

┌─────────────────┐
│   Desktop App   │ ← User manages variables via GUI
└────────┬────────┘
         ↓ Writes to
┌─────────────────┐
│   vars.json     │ ← Local storage (AppData / Library)
└────────┬────────┘
         ↓ Reads from
┌─────────────────┐
│ Python Library  │ ← Scripts call hedgebuddy.var()
└─────────────────┘

Storage: %APPDATA%\hedgebuddy\vars.json (Windows) · ~/Library/Application Support/hedgebuddy/vars.json (macOS)

Documentation

📖 Full Documentation

• Python Library
• Desktop App
• Examples

Development

# Python library
cd python-lib && pip install -e . && pytest

# Desktop app
cd hedgebuddy-wails && wails dev

Links

PyPI · GitHub · Releases · Issues

Disclaimer

HedgeBuddy is an independent, open-source project. NOT affiliated with Hedge (hedge.co). MIT License.