Impee

One-click launcher for your local project entry points.

Store a working directory + command (e.g. python insights_api.py, npm run dev, npm start) and launch or stop them from a simple web UI.

Stack

• Backend: FastAPI + SQLite + subprocess launcher
• Frontend: React (Vite)

On Windows, Launch opens a new CMD or Anaconda Prompt window (not a background process). The window stays open so you can read logs (cmd /k).

If conda is not auto-detected, set IMPEE_CONDA_ROOT to your Anaconda/Miniconda install folder.

Setup

Backend

cd backend
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python api.py

API: http://127.0.0.1:8000
Docs: http://127.0.0.1:8000/docs

Alternatively: uvicorn app.main:app --reload (same folder, venv active).

Frontend

cd frontend
npm install
npm run dev

UI: http://127.0.0.1:5173

Usage

1. Open the UI and click Add entry point
2. Fill in:
   • Name — e.g. Insights API
   • Working directory — absolute path to the project folder
   • Command — e.g. python insights_api.py or npm run dev
   • Terminal — CMD or Anaconda Prompt (optional conda env name)
3. Click Launch — a new terminal window runs the command
4. Click Stop to kill the process tree

Entry points are stored in data/impee.db.

API overview