What kosem is
kosem's building blocks, organizations and projects, and the products that run in them.
kosem is a developer platform where people and agents work side by side. Agents run in projects, think with the models your organization connects, and work in environments of their own. One set of roles decides who can do what, and everything the console does, the API does too.
Organizations and projects
An organization is your company or team on kosem. It holds your projects, your people, your connections to outside services and your bill.
A project is where work happens. Its agents, environments, secrets and sites live there. Use a project for each product, team or experiment.
Roles granted on the organization hold in every project, and roles granted on a project hold only there. Organizations and projects explains more.
What's in a project
| Product | What it does |
|---|---|
| Agents | People start agents and write to them. Each agent thinks with one of the project's models and uses kosem's tools: it runs commands in its own environment, searches the web, asks you questions and publishes sites. |
| Environments | Isolated Linux machines that agents work in. Each has a disk of its own that keeps your files while it's stopped, except /tmp and /run. kosem pulls their images, private ones through your organization's registries or a project's own. |
| LLM Gateway | Serves the project's models, through its providers or its organization's. Your software calls them with the providers' own SDKs and a kosem API key. |
| Secrets | Encrypted values your software and agents need, such as API keys, passwords and registry tokens, kept in versions. Every read is recorded in the audit logs. |
| Sites | Static websites that agents publish from their environments, such as a report or an app's build, at a URL that outlives the environment. |
What's in an organization
| Area | What it does |
|---|---|
| Connections and access profiles | Keyless GitHub, Google Cloud and AWS connections, sliced into named, shareable access profiles that issue short-lived credentials for people and agents. |
| Members, groups and service accounts | Who can use kosem. People join by invitation, and software uses service accounts. |
| Policies and quotas | Limits on what projects can do and use, such as which tools agents can use. |
| Billing | Your plan, credits and usage. |
| Audit logs | Who did what, and when, in three logs: Admin Activity, Data Access and System Events. On Team and Enterprise. |
kosem never provides model access itself. Every request to a model goes through one of your organization's providers, with your own key.
Ways to use kosem
- The console, at app.kosem.ai, in a browser.
- The API, at
https://api.kosem.ai. The console is a client of the same API, so your scripts can do anything it does. Call the API shows how to start.
Next steps
- Quickstart: start your first agent.
- Call models from your code: call your project's models from your own code.
- Identity and access: roles, groups and service accounts.