Quick Start
Create your first organization, provider, agent, and run it.
This walkthrough assumes the platform is already running — see Installation if you haven't set it up yet.
1. Sign in
There is no public sign-up. The platform administrator account is created when the platform first starts, from the administrator credentials set during installation. Open the app and sign in with it. Everyone else joins an organization through an e-mail invitation sent by an organization owner or admin.
2. Create an organization and project
Every resource in UnderOcean belongs to a project, which belongs to an organization:
Organization → Projects → Agents / Flows / Knowledge Bases / IntegrationsThe platform administrator creates the organization (Organizations in the sidebar) and invites its first members. An organization owner or admin then creates a project from the dashboard with New Project.
3. Connect an LLM provider
Go to Project → AI Providers and add a provider configuration:
- Choose a provider type (e.g. OpenAI, Anthropic, Ollama)
- Enter the model name (e.g.
gpt-4o,claude-sonnet-4-5) - Paste your API key — it is encrypted at rest and is never returned by the API afterward
- For a self-hosted or OpenAI-compatible endpoint, choose Custom and set the base URL
See Guides → Connect a Provider for more detail.
4. Create an agent
Go to Project → Agents → New Agent and configure:
- A system prompt
- The provider + model to use
- Temperature and max tokens
- Any tools the agent should have access to
5. Run the agent
Open the agent's chat view and send a message. Responses stream token-by-token in real time, and you can expand the inference steps panel to see the underlying thought → action → observation loop as it happens.
Next steps
- Build your first flow to orchestrate multiple agents and tools together
- Set up a knowledge base to give an agent Agentic-RAG retrieval over your own documents