iVistaar

Install guide

iVistaar is an internal deployment control plane for Windows Server/IIS that gives Flask, Dash, and Streamlit apps an org URL without Git or cloud services. Prefer Waitress service mode.

1. Prerequisites

2. Extract

Download iVistaar-latest.zip and extract to a permanent path:

C:\iVistaar

You should see VERSION, INSTALL.md, scripts\, and admin\.

3. Install (recommended)

Elevated PowerShell from the extract folder:

cd C:\iVistaar
.\scripts\install-admin-service.cmd -Port 8080

This starts the admin UI as scheduled task iVistaarAdmin and hosts apps with Waitress (avoids common IIS HttpPlatformHandler 500s).

Optional: pass -PythonPath "C:\...\python.exe" if discovery picks the wrong interpreter.

4. First login

Open http://localhost:8080/ (or http://<server-name>:8080/).

The installer generates per-install credentials — change them under Account. See also INSTALL.md in the zip.

5. Deploy an app

  1. Optional: unzip a sample under sample-apps\ (customer packages ship samples as .zip files).
  2. Admin → Connect → folder path + entrypoint (Flask app:app, Dash app:server / run:server).
  3. Deploy → open /apps/<slug>/.
  4. Use the deployment page Health & runtime panel and Runtime log if something fails.

If an LLM is writing the app, paste the intern briefing into Cowork, Claude, Cursor, or ChatGPT first — so it aims at /apps/<slug>/ instead of /.

6. Upgrade later

  1. Download the new zip.
  2. Stop iVistaarAdmin (or the IIS app pool).
  3. Extract over the install folder — keep the existing data\ folder.
  4. Re-run install-admin-service.cmd -Port 8080.

More help

Full text guide in the package: INSTALL.md / INSTALL.txt. Building with Cowork or Cursor? Intern briefing. Questions: [email protected].