Deployment modes & plugins

OneOpen ML Studio runs as Local, Team, or Enterprise based on ONEOPEN_DEPLOYMENT_MODE (not a UI toggle).

Mode	How you get it	First visit
Local	Default / `pip install`	Studio opens immediately
Team	Docker Compose / `ONEOPEN_DEPLOYMENT_MODE=team`	`/setup` — create team + first admin
Enterprise	K8s / `ONEOPEN_DEPLOYMENT_MODE=enterprise`	`/setup` — create organization + first admin

First-time setup (Team & Enterprise)

When auth is on and the database has no users, the app redirects to /setup:

Enter your team / organization name (and optional slug)
Name the default workspace
Create the first admin email and password

You are signed in afterward and can invite members from Organizations.

GET  /api/setup/status
POST /api/setup

Headless alternative (no wizard):

export ONEOPEN_BOOTSTRAP_ON_START=true
export ONEOPEN_ADMIN_EMAIL=admin@company.com
export ONEOPEN_ADMIN_PASSWORD='strong-password'
# or: oneopen user create-admin --email … --password …

Organizations & workspaces

Open Organizations / Teams in the sidebar (/orgs).

New workspace — on an org page (/orgs/{id} → New workspace)
Members — add users by email (optional password creates the account), change roles, remove
Roles & permissions — built-in map + custom roles with chosen capabilities
Workspace Members tab — same controls at workspace scope

Custom roles (Team / Enterprise):

GET    /api/orgs/{id}/roles
POST   /api/orgs/{id}/roles
PATCH  /api/orgs/{id}/roles/{role_id}
DELETE /api/orgs/{id}/roles/{role_id}

Team installs label the nav Teams; Enterprise uses Organizations.

POST   /api/orgs
POST   /api/orgs/{id}/workspaces
GET    /api/orgs/{id}/members
POST   /api/orgs/{id}/members
PATCH  /api/orgs/{id}/members/{membership_id}
DELETE /api/orgs/{id}/members/{membership_id}
GET    /api/workspaces/{id}/members
POST   /api/workspaces/{id}/members

Plugin manager

Open Plugins (/plugins) to:

See installed / missing extras
Install / Upgrade / Uninstall
Check import status

GET    /api/plugins/extras
POST   /api/plugins/extras/{extra}/install
POST   /api/plugins/extras/{extra}/uninstall
DELETE /api/plugins/extras/{extra}
GET    /api/plugins/manager/status