You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Build on and operate Devias, an open-source business operating system. Install and write modules, call the HTTP API and TypeScript SDK, configure workflows and agents, and host the server. Use when a task involves Devias records, modules, workflows, agents or its API.
Devias
Devias is an open-source platform that works as an operating system for a business. A core provides records, views, workflows, tasks, documents, agents and permissions. Modules add areas of the business: customers, quotes, invoices, payments, expenses, products, stock and connections to outside services. It runs on the user's own server with Postgres, or with an embedded database to try it. It is young and changes quickly. If these docs and the source repository (github.com/devias-io/devias) disagree, the repository is right.
What an agent can do with Devias
Read and write business data through the HTTP API or the TypeScript SDK. See HTTP API and TypeScript SDK.
Install, update and uninstall modules with a plan that is reviewed before it is applied. See Plan and apply.
Write a module: objects and fields, views, layouts, navigation, actions with server code, connections to outside services, workflows, agents and skills. See What a module is.
Automate work with workflows that start from a record change, a task change, a schedule, a module event or a manual run. See Workflows and tasks.
Define agents with instructions and a tool list, each tool set to run freely or ask first. See Define an agent.
Follow changes as a server-sent events stream. See Change feed.
Host Devias: deploy the server and the studio, choose the database, set environment variables. See Deploy.
Inputs and credentials
Input
Where it comes from
Server URL
http://localhost:3000 by default
Workspace id
Settings → General in the studio. It is not a uuid.
API key
Settings → API keys. A key made there can read records. Plan and apply need a key created through the API with { "module": ["manage"] }. Sent in the x-api-key header.
AI provider key
ANTHROPIC_API_KEY, GEMINI_API_KEY or OPENAI_API_KEY, with AI_PROVIDER. Without one, agents are off and everything else works.
Constraints
Every id in a module (module, object, field, view, action, workflow, step, connection, variable, event, policy) is a uuid made once and never changed. Generate ids with devias id <count>. Do not write readable or dotted ids.
Run devias plan and read it before devias apply. Deletions need --allow-destructive. Apply is tied to the plan that was reviewed.
A module owns what it declared. A workspace cannot edit or delete those items. It can add its own fields to the module's objects and copy a module's workflow.
Every request, from a person, key, workflow, module or agent, passes one permission check. An agent acts with the role of the person who asked and cannot exceed it.
A tool set to Ask first waits for an approval. Do not try to route around it.
Workflows act as themselves and cannot change workspace settings. A workflow's changes never start workflows. Workflow runs go one at a time in a workspace, so actions must be short and safe to repeat.
Policies declared by a module are experimental: they are shown, not enforced.
Common workflows
Create and install a module
Generate ids: devias id 6.
Write src/manifest/index.ts with defineModule, listing objects, views and navigation.
List the package in devias.config.ts.
Run devias plan -w <workspaceId> -m ./src/manifest/index.ts, read the output, then devias apply with the same flags.