New Indrayala README.md

Indrayala — Local Knowledge Infrastructure for Sovereign Collaboration

Indrayala is a local-first, schema-driven application framework with built-in agent governance. It enables structured applications, peer-to-peer replication and explainable rule systems — without surrendering control to centralized SaaS platforms or autonomous AI agents.


Overview

Indrayala provides:

  • local knowledge infrastructure
  • schema-driven app compiler and runtime
  • changeset-based replication system
  • An agent-friendly execution environment
  • governance layer between AI and user
  • Peer-to-peer collaboration without central servers

Indrayala is not a cloud service. It is a local runtime for structured knowledge systems.


Declarative Applications

Applications in Indrayala are defined declaratively using YAML schemas.

From a schema, Indrayala generates:

  • SQLite database structures
  • Foreign keys and constraints
  • Generated fields
  • Default values
  • Views and predicates
  • UI widgets
  • Context actions
  • Aggregations
  • Data propagation rules

Indrayala compiles schemas into working applications.

Example (simplified):

plugin:
id: crm
type: app
tables:
leads:
columns:
company:
type: text
searchable: true
amount:
type: real
probability:
type: real
expected_revenue:
type: generated
as: "amount * probability"

Changeset-Based Replication (P2P)

Application data can be replicated using changesets:

  • Full app replication
  • Selective dataset replication
  • Single-record exchange
  • Offline-first synchronization

Replication is peer-to-peer.
No central service is required.

This enables sovereign collaboration between independent nodes.


Agent-Friendly, Human-Governed

Indrayala is designed to interact with AI agents — but never to be controlled by them.

Agents can:

  • Propose actions
  • Suggest data updates
  • Generate Method-Cards
  • Compile rules

Agents cannot:

  • Execute changes autonomously
  • Modify data without approval

All proposals appear in a Sidebar.
The human decides.

Indrayala acts as a governance buffer between AI systems and the user.


Method-Cards & Rule Compilation (future development)

Method-Cards describe structured reasoning steps.

A lightweight AI compiler translates them into:

  • CLIPS rules
  • Deterministic inference logic
  • Transparent decision proposals

Rules generate suggestions — not automatic execution.

This ensures:

  • Explainability
  • Determinism
  • Local execution
  • Auditability

Architectural Principles

  • Local-first
  • Open formats
  • Declarative over imperative
  • Peer-to-peer instead of platform dependency
  • Human-in-the-loop AI
  • Explainable logic

Inspired by Indra’s Net: Each node mirrors the whole. No central authority is required.


Technology

  • Python
  • PySide6 / Qt
  • SQLite
  • Changesets
  • LibreOffice UNO integration
  • YAML schemas
  • JSON configuration
  • CLIPS (planned integration)
  • P2P transport layer (e.g. croc / Syncthing)

What Indrayala Is Not

  • Not SaaS
  • Not a cloud CRM
  • Not autonomous AI
  • Not vendor lock-in

It is infrastructure.


License

This project is licensed under the Mozilla Public License 2.0 (MPL-2.0). See the LICENSE file for details.