Quickstart
Get your development environment configured in minutes with Prism.
Prerequisites
- Python 3.9+
- Git
make install-dev
Option A: Web UI (Recommended)
make run
# Opens at http://localhost:5555
The web UI walks you through:
- Choose a prism — prism, startup, acme-corp, fortune500, etc.
- Select sub-prisms — pick your role, division, team, etc.
- Select tools — tool selection page with categories (Core, Editor, Containers, Runtime, Cloud, Kubernetes, CLI), hover tooltips, and platform-aware filtering
- Fill in your info — name, email, platform-specific fields (inline validation, no alerts)
- Install — watch the live progress log; cancel/retry if needed
Option B: CLI
# Install from PyPI
pip install prism-dx
prism install
# Install a specific prism
prism install --prism prism
# Install with a custom npm registry (corporate environments)
prism install --prism fortune500 --npm-registry https://npm.mycompany.com
What Gets Installed
After installation you’ll have:
~/workspace/
+-- projects/ <- your code lives here
+-- experiments/
+-- learning/
+-- archived/
+-- docs/
| +-- config/ <- your prism configuration files
| +-- merged-config.yaml <- the merged result of all sub-prisms
| +-- user-info.yaml
+-- tooling/
Plus:
- Git configured with your name and email
- SSH key generated (
~/.ssh/id_ed25519) - Only the tools you checked in the UI get installed (from the centralized tool registry)
- Repositories cloned (if declared in your prism)
- A
.prism_rollback.jsonmanifest for undoing the installation
Rollback
If something goes wrong, reverse the installation:
prism rollback ~/workspace
The rollback engine reads .prism_rollback.json and undoes all recorded actions in LIFO order (uninstalls tools, deletes files and directories, restores config changes).
Installation History
View previous installations on your machine:
prism history
Also available via the /api/history endpoint.
Your First Custom Prism
# Create a scaffold for your company
prism packages create my-company --company "My Company"
# Customize the base configuration
vim prisms/my-company.prism/base/my-company.yaml
# Add tools to the tool registry
vim prisms/my-company.prism/base/tool-registry.yaml
# Validate it
prism packages validate my-company
# Install it
prism install --prism my-company