Management UI

Knull includes a comprehensive web platform for managing your AI infrastructure, identity, and costs.

Navigation Sections

1. Catalog & Provisioning

• Model Catalog: View all configured models across providers.
• AWS Cloud: Connect your AWS account and provision Bedrock models with one click. Supports managing Inference Profiles and region-specific enablement.

2. Identity & Access Management (IAM)

• Users & Teams: Manage user accounts and group them into teams for collaborative access.
• Roles & Permissions: Define fine-grained RBAC roles (e.g., Administrator, Auditor, Developer).
• Invitations: Securely invite new team members via email.

3. Analytics & Cost

• Dashboard: Real-time overview of request volume, token usage, and active models.
• Cost Sankey: Visualize how costs flow from specific teams and API keys to LLM providers.
• Time-Series Graphs: Analyze historical usage patterns with flexible granularity.
• Cloud Costs: Integrated view of actual AWS cloud billing data.

4. Developer Tools

• AI Playground: Chat interface to test and compare models directly.
• API Key Management: Generate and manage client-facing keys with policy assignments.
• Audit Logs: Traceable history of all administrative actions.

Getting Started

1. Initial Setup (Bootstrap)

The first time you access the UI, you will be prompted to create the initial Administrator account. This "Bootstrap" phase ensures the system is secured from the start.

2. Environment Configuration

The UI communicates with the Knull Admin API. Ensure your environment is configured correctly:

# .env.local
NEXT_PUBLIC_KNULL_API_URL=http://localhost:8000

3. Local Development

cd knull/ui
npm install
npm run dev

Security & Authentication

The UI uses JWT-based authentication. Session tokens are stored securely in local storage and included in all API requests. For enterprise deployments, ensure the UI is served over HTTPS.