vibefoundry 0.1.309

A local IDE for data science workflows with script running, metadata generation, and GitHub Codespace sync

VibeFoundry IDE

A local desktop IDE for data analysis with Claude Code running in a GitHub Codespace sandbox.

Features

• Local File Management - Browse and manage your project files
• Codespace Integration - Connect to a GitHub Codespace running Claude Code
• Script Runner - Run Python scripts locally with auto-preview of outputs
• Data Preview - View CSV, Excel, and image files directly in the IDE
• Bidirectional Sync - Scripts sync between local and codespace

Installation

# Install the package
pip install -e .

# Build the frontend
cd frontend && npm install && npm run build && cd ..

Usage

# Launch the IDE
vibefoundry

# Or specify a project folder
vibefoundry /path/to/project

Development

# Run frontend dev server
cd frontend && npm run dev

# Run backend separately
python -m vibefoundry.server

Publishing

The publish flow reads the PyPI token from .env (gitignored):

PYPI_TOKEN=pypi-...

.env is expected to be present in the project root — publish.sh sources it automatically. Bump the version and ship:

./publish.sh 0.1.307

Architecture

• frontend/ - React-based UI (Vite + React)
• src/vibefoundry/ - Python backend (FastAPI)
  • server.py - Main API server
  • watcher.py - File change detection
  • runner.py - Script execution
  • metadata.py - Metadata generation