GitHub - sabbanis/opra.ai: Free GitHub-native operating layer for governed local business workflows. · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
sabbanis
opra.ai
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>4 Commits<br>4 Commits
.github
.github
apps
apps
demos
demos
docs
docs
modules
modules
packages
packages
platform
platform
tests
tests
tools
tools
.env.example
.env.example
.gitignore
.gitignore
.python-version
.python-version
LICENSE
LICENSE
README.md
README.md
pyproject.toml
pyproject.toml
View all files
Repository files navigation
opra.ai
Free, GitHub-native operating layer for governed business workflows.
opra.ai stores business records as human-readable files, validates them locally, runs governed mutations through RBAC and approval policy, emits audit evidence, and exposes demo workflows through CLI, API, browser UI, GitHub pull requests, and Skills.
This repository is the free developer-preview edition. It is meant for local evaluation, forks, demos, and self-directed experimentation.
What You Can Do Today
Validate CRM source records.
Inspect source records as JSON.
Run governed local writes with audit events.
Create mutation proposal artifacts.
Validate proposal pull requests with GitHub Actions.
Map GitHub reviews into approval evidence.
Generate proposal check reports for Actions summaries.
Build local CRM dashboard read models.
Run local CRM Skills.
Use a browser workspace from a local API server for CRM, records, proposals, GitHub previews, and audit evidence.
Create and update mock GitHub Issue previews.
Publish real proposal PRs and GitHub Issues with gh when you choose to use live GitHub integration.
Current Limits
The CLI module names are still company_os_cli and company_os_core during this developer preview.
CRM is the primary complete demo path.
Issue Management and HR scaffolds exist, but CRM has the strongest local workflow coverage.
The browser workspace is local-first and intentionally dependency-free.
GitHub integration uses the local git and gh CLIs for live operations.
Quickstart
git clone https://github.com/sabbanis/opra.ai.git<br>cd opra.ai<br>export PYTHONPATH=packages/company_os_core/src:packages/company_os_cli/src<br>python3 -m unittest discover -s tests<br>python3 -m company_os_cli doctor
Validate the CRM seed records:
python3 -m company_os_cli validate --file modules/crm/objects/accounts/acct_acme.yaml<br>python3 -m company_os_cli validate --file modules/crm/objects/opportunities/opp_acme_renewal_2026.yaml
Build the CRM read model and run a Skill:
python3 -m company_os_cli index-crm<br>python3 -m company_os_cli crm-skill --name pipeline-summary --user ssabbani --role sales_rep
Run the local browser workspace:
python3 apps/api/server.py --repo-root . --port 8080
Open:
http://127.0.0.1:8080/
Onboarding Docs
Start here:
Getting Started
Onboarding Checklist
Local Development Setup
First CRM Demo
Governed Proposal Workflow
GitHub Integration
Repository Boundary
Testing Guide
Troubleshooting
Repository Layout
modules/ Product modules: CRM, Issues, HR<br>platform/ RBAC, audit, dashboards, GitHub integration, proposals<br>apps/ Local API, browser UI, workers scaffold<br>packages/ Shared Python packages<br>demos/ Seed data, scripts, narratives<br>docs/ Free onboarding docs<br>tests/ Unit, integration, and e2e tests
Local Check
Run the current no-dependency test suite:
PYTHONPATH=packages/company_os_core/src:packages/company_os_cli/src python3 -m unittest discover -s tests
Run the CLI doctor command:
PYTHONPATH=packages/company_os_core/src:packages/company_os_cli/src python3 -m company_os_cli doctor
License
The source code in this repository is licensed under the Apache License 2.0.<br>See LICENSE.
A future hosted service or commercial support offering may use separate terms and a distinct edition name. The Apache-2.0 license for this source repository remains unchanged.
About
Free GitHub-native operating layer for...