{"id":39825040,"url":"https://github.com/objectstack-ai/objectos","last_synced_at":"2026-06-03T04:00:43.291Z","repository":{"id":360011919,"uuid":"1248087136","full_name":"objectstack-ai/objectos","owner":"objectstack-ai","description":"The Business OS. A headless operating system providing Identity, RBAC, Workflow, and Audit Logging for your applications.","archived":false,"fork":false,"pushed_at":"2026-05-24T15:29:40.000Z","size":356,"stargazers_count":0,"open_issues_count":8,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T16:27:05.973Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.objectos.org","language":"MDX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/objectstack-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-24T07:04:57.000Z","updated_at":"2026-05-24T15:29:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/objectstack-ai/objectos","commit_stats":null,"previous_names":["objectstack-ai/objectos"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/objectstack-ai/objectos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/objectstack-ai%2Fobjectos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/objectstack-ai%2Fobjectos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/objectstack-ai%2Fobjectos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/objectstack-ai%2Fobjectos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/objectstack-ai","download_url":"https://codeload.github.com/objectstack-ai/objectos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/objectstack-ai%2Fobjectos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33847265,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-03T02:00:06.370Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-18T13:03:47.505Z","updated_at":"2026-06-03T04:00:43.270Z","avatar_url":"https://github.com/objectstack-ai.png","language":"MDX","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ObjectOS\n\n\u003e **The business platform AI can actually use — running in your own environment.**\n\u003e\n\u003e ObjectOS is the AI-native runtime for [ObjectStack](https://github.com/objectstack-ai/framework)\n\u003e applications. Put your business systems — CRM, contracts, tickets,\n\u003e approvals, anything modeled in ObjectStack metadata — on ObjectOS, and\n\u003e AI agents can safely query, analyze, and act on that data under your\n\u003e permissions, on your servers, with every step audited.\n\n**ObjectStack** is a metadata protocol for describing business\napplications — objects, permissions, workflows, APIs, UI, and AI tools —\nin one structured definition.\n**ObjectOS** is where those applications run, and where AI plugs in.\n\n```\nObjectStack   →   how a business application is described\nObjectOS      →   where it runs, and where AI plugs in\n```\n\n## Why ObjectOS\n\nThe promise of \"AI inside the enterprise\" usually breaks on two things:\nAI can't actually use the business system, and security can't say yes\nto letting it try. ObjectOS removes both blockers:\n\n- **Every object is an AI tool, automatically.** Define a business\n  object once in ObjectStack metadata; ObjectOS exposes it to AI agents\n  as a governed, callable tool — no glue code, no separate integration\n  layer to maintain.\n- **AI acts as the signed-in user.** Whatever that person is allowed to\n  see or do, the agent can — nothing more. The boundary is enforced in\n  the runtime, not in the prompt.\n- **One audit log for humans and agents.** Every read, write, and\n  escalation — by a person or an AI — is recorded with who, what, when,\n  and why. Compliance gets one log to look at, not two.\n- **Permissions enforced at the runtime.** Role-based access,\n  record-level rules, and field-level redaction run inside ObjectOS, so\n  the same policy applies whether the call comes from the UI, an API\n  client, or an agent.\n- **Your data, your network.** Runs in your environment — private cloud,\n  on-prem, or fully air-gapped. Business data and AI prompts stay\n  inside your perimeter; no third party in the loop.\n- **Plugs into the identity you already operate.** OAuth, OIDC, SAML,\n  corporate SSO, or local accounts. AI sessions inherit the same\n  identity, MFA, and offboarding — no separate \"AI account\" to govern.\n\n## Positioning\n\n| | ObjectStack framework | **ObjectOS** | Plugins |\n|---|---|---|---|\n| Role | The protocol — *how* an application is described | The runtime — *where* it runs and where AI plugs in | Anyone-can-write extensions on top of the runtime |\n| Repo | `objectstack-ai/framework` | `objectstack-ai/objectos` | Any repo publishing `@objectos/plugin-*` (or your own scope) |\n| What it ships | Protocol, kernel, `@objectstack/*` packages, Console, control plane | Runtime distribution + Docker/Helm + ops docs | Drivers, identity providers, audit exporters, custom UI, AI tools, integrations — your call |\n| Who builds it | Framework contributors | Distribution maintainers | **Anyone** — community, vendors, your own team |\n| License | Apache-2.0 | **Apache-2.0** | Author's choice (Apache-2.0, MIT, commercial, internal-only) |\n| Release cadence | Frequent (per `changeset`) | Distribution semver (e.g. `2026.05 LTS`) | Independent — plugins version themselves |\n\nPlugins are first-class: ObjectOS exposes the same extension points the\ncore uses. See [`packages/`](packages/) for reference plugins, and the\n[plugin authoring guide](content/docs/extend/plugins.mdx) to publish\nyour own.\n\n## Boot modes\n\nObjectOS boots in one of two modes, selected by environment variables:\n\n| Mode | Required env | Use case |\n|---|---|---|\n| **Cloud-connected** | `OS_CLOUD_URL`, `OS_PROJECT_ID` | Production with the ObjectStack control plane / Console |\n| **Offline / air-gapped** | `OS_ARTIFACT_FILE` | Compile locally with the CLI, ship the JSON artifact, run anywhere |\n\nSee [`apps/objectos/objectstack.config.ts`](apps/objectos/objectstack.config.ts).\n\n## Quick start\n\n```bash\npnpm install\n\n# Build the runtime distribution and docs\npnpm build\n\n# Boot the runtime against a local compiled artifact\ncd apps/objectos\nOS_ARTIFACT_FILE=dist/objectstack.json PORT=3200 pnpm start\n\n# Or run the documentation site\npnpm docs:dev\n```\n\n### Docker\n\n```bash\nmkdir -p docker/artifacts\ncp apps/objectos/dist/objectstack.json docker/artifacts/objectstack.json\ndocker compose -f docker/docker-compose.yml up --build\n```\n\nDocker Compose publishes ObjectOS on `http://localhost:3000` by default.\nUse `OBJECTOS_PORT=3200` to change the host port.\n\n## Repository layout\n\n```\nobjectos/\n├── apps/\n│   ├── objectos/            # Runtime entry — single objectstack.config.ts\n│   └── docs/                # Product / operations site (Fumadocs + Next.js)\n├── packages/                # Plugins (@objectos/plugin-*) — anyone can write one\n├── content/docs/            # MDX content powering apps/docs\n├── docker/                  # Dockerfile + docker-compose\n├── helm/                    # Helm chart (planned)\n├── examples/                # Reference deployments\n├── e2e/                     # Black-box smoke tests against the published image\n└── scripts/\n```\n\n## Documentation\n\n- [Quickstart](content/docs/quickstart.mdx)\n- [Architecture](content/docs/architecture.mdx)\n- [Deployment](content/docs/deploy/index.mdx) — Docker, Kubernetes, air-gapped\n- [Authentication](content/docs/configure/authentication.mdx)\n- [Permissions](content/docs/configure/permissions.mdx)\n- [Observability](content/docs/operate/observability.mdx)\n\n## History\n\nThe current `main` is a deliberate restart aligned with the\n[ObjectStack North Star](https://github.com/objectstack-ai/framework/blob/main/content/docs/concepts/north-star.mdx).\n\n## License\n\nObjectOS is licensed under the [Apache License 2.0](LICENSE).\n\n\"ObjectOS\" and the ObjectOS logo are trademarks of the ObjectOS project\nand are not covered by the Apache 2.0 grant. See [TRADEMARK.md](TRADEMARK.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fobjectstack-ai%2Fobjectos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fobjectstack-ai%2Fobjectos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fobjectstack-ai%2Fobjectos/lists"}