Download & Deploy
Choose your platform, install dependencies, and launch UPtrim.
Windows
> py -3.12 -m venv .venv
> .venv\Scripts\activate
> pip install fastapi httpx uvicorn
> py -3.12 main.py --web
macOS
$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip install fastapi httpx uvicorn
$ python3 main.py --web
Linux Desktop
$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip install fastapi httpx uvicorn
$ python3 main.py --web
Linux Server
$ wget https://your-domain.com/releases/contextproxy-linux-server.tar.gz
$ tar -xzf contextproxy-linux-server.tar.gz
$ cd contextproxy
$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip install fastapi httpx uvicorn
$ python3 main.py --headless --host 0.0.0.0 --port 9099 --workers 2
Launch Modes
Three ways to run the proxy depending on your environment and workflow.
Web Dashboard
Full browser-based operator UI with memory management, user admin, and live monitoring.
$ python3 main.py --web
TUI
Rich terminal dashboard built with Textual. Perfect for SSH sessions and headless boxes.
$ python3 main.py --tui
Headless API
Bare proxy with no UI. Ideal for production servers, Docker containers, and systemd services.
$ python3 main.py --headless