Skip to content
This repository was archived by the owner on Mar 27, 2026. It is now read-only.

INSTALL.md

Latest commit

 

History

History
85 lines (56 loc) · 3.21 KB

INSTALL.md

File metadata and controls

85 lines (56 loc) · 3.21 KB

DivineOS — One-command setup

Install DivineOS so Cursor can use its MCP tools (governance, memory, council, Tribunal, etc.).
Last updated: 2026-03-02.

Prerequisites

  • Cursor (with MCP support)
  • Python 3.8+ on your PATH
  • Git (to clone the repo)

One command (from a new folder)

git clone <your-divineos-repo-url> divineos && cd divineos && pip install mcp -q && echo "Add MCP server in Cursor: command=python, args=[$(pwd)/divineos_mcp_server.py], cwd=$(pwd)"

Then in Cursor:

  1. Open Settings → MCP (or Cursor Settings → Features → MCP).
  2. Add a new server:
    • Command: python
    • Args: [C:\path\to\divineos\divineos_mcp_server.py] (use the path the command printed; Windows use backslashes or the path your terminal showed).
    • Cwd: C:\path\to\divineos (same directory as divineos_mcp_server.py).
  3. Restart Cursor (or reload MCP).

Replace <your-divineos-repo-url> with the real clone URL (e.g. https://github.com/yourorg/divineos.git). If you already have the repo, just cd to its root and run:

pip install mcp -q

Then add the MCP server in Cursor with command = python, args = [path/to/divineos_mcp_server.py], cwd = repo root.

Verify

  • In Cursor chat, ask: “Use divineos_system_info and tell me what you get.” The AI should call the tool and show system info.
  • Or run the demo: from repo root, python scripts/demo_marketplace.py.
  • One request + one recall: Ask "Should I do X?" then "What did we just decide?" — confirms pipeline and memory.
  • Tool count: From repo root, python scripts/list_mcp_tools.py — expect 44 tools.
  • Guarantees and 44 tools: docs/WHAT_WE_GUARANTEE.md; full list in README.md § "The 44 MCP tools."

Troubleshooting

Issue Fix
“Module not found” when starting MCP Cwd in Cursor must be the repo root (where law/, memory/, core/ live).
“No such file divineos_mcp_server.py” Use the full path to divineos_mcp_server.py in Args.
Tools don’t appear in Cursor Restart Cursor after adding the server; check Cursor’s MCP or Developer logs.
Pip install fails Use pip install mcp; if the repo has a requirements.txt, run pip install -r requirements.txt from repo root.

What was blocked and why: After using the pipeline, you can list recent blocks and overrides: python scripts/recent_blocks.py and python scripts/recent_overrides.py, or in Cursor use MCP tools divineos_recent_blocks and divineos_recent_overrides.

Production security

For production deployments, enable optional security middleware (CORS, security headers, trusted host):

export DIVINEOS_SECURITY_ENABLED=1   # Linux/macOS
# Then: python api_server.py

See docs/PRODUCTION_SECURITY.md for what it enables and how to set required secrets.

Optional: lock the core (marketplace / production)

To make the core constitution files read-only so they can’t be changed by mistake:

python scripts/set_immutable_core.py

See docs/IMMUTABLE_CORE.md for the list of protected files and how to override.