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

Install the package (from the repo root):

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .

Start the API:

impee summon

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

Optional flags: --host, --port, --no-reload.

Backend (development without installing)

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

Frontend

cd impee/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