Skip to Content
kosemdocs
Get started

Quickstart

Sign in, create an organization with its first project, connect a model, and start your first agent.

In this tutorial, you set up kosem from the start and run an agent that writes and runs code in an environment of its own. It takes about 10 minutes.

Before you start

You need:

  • An email address. kosem signs you in with a code it emails you.
  • An API key from a model provider, such as Anthropic or OpenAI. kosem calls models through your organization's own keys, and never provides model access itself.

1. Sign in

  1. Open app.kosem.ai.
  2. Enter your email address and click Continue with email.
  3. Enter the 8-digit code from the email kosem sends you. Your first sign-in creates your account.

2. Create an organization and a project

kosem asks you to create your organization, with its first project.

  1. Enter your name.
  2. Enter the organization's name, such as your company's. kosem makes its address from it, which is part of the console's URLs and never changes. An address has 6 to 30 lowercase letters, digits or hyphens: if the name is shorter, click Change address and enter a longer one.
  3. Keep the first project's name, My First Project, or enter another.
  4. Click Create organization.

You're the organization's Owner, so you can do everything in this tutorial. kosem opens the project's Home page.

3. Add a provider

A provider is your API key for a model provider. Add it to your project, which keeps it for itself. Your organization can also add providers and share them with its projects.

  1. In your project, click LLM Gateway.
  2. Under Set up your first model, click Add a provider, and select yours, such as Anthropic.
  3. Paste your provider's API key and click Add provider.

4. Add a model

A model is a name, such as fast, that the project calls one of the provider's models by.

  1. Click Choose a model, and select your provider.
  2. Select a model and click Next.
  3. Enter an alias for it, such as fast.
  4. Click Add model.

5. Start an agent

  1. Click Agents.

  2. In the message box, write what you want the agent to do, such as:

    Write a Python script that prints the first 10 prime numbers, run it, and show me what it prints.
  3. Click Start the agent.

The agent's answer appears as it writes it. It runs its commands in an environment of its own, which you can find under Environments.

What you did

  • Created an organization and a project in it.
  • Added a provider to your project, and one of its models.
  • Started an agent that works in its own environment.

Next steps

On this page