bitflicker64 commented on code in PR #543: URL: https://github.com/apache/hugegraph-doc/pull/543#discussion_r4418790288
########## content/en/docs/quickstart/hugegraph-ai/ontogeny.md: ########## @@ -0,0 +1,108 @@ +--- +title: "Ontogeny" +linkTitle: "Ontogeny" +weight: 7 +--- + +**Ontogeny** is an evolving operational ontology platform for AI applications, located in the [HugeGraph-AI](https://github.com/apache/hugegraph-ai/tree/ontogeny) module. +It models business semantics (entities, properties, relations) and operations (actions, functions, policies) as declarative, Git-native YAML specifications. +These are exposed to applications and AI agents through a governed API, with optional projection to [Apache HugeGraph](https://github.com/apache/hugegraph) for deep graph queries. + +### Architecture Overview + +The following diagram illustrates core modules and operational flows: + + + +The system consists of three architectural layers: +- **Top Layer**: Core DSL definitions, where Action serves as the sole write gateway and EvalSuite provides quality evaluation. +- **Middle Layer**: The online pipeline (modeling → exploration → execution → control → audit) and offline self-evolution (RSI) loop, with Agent operations unified under policy access control. +- **Bottom Layer**: Platform runtime and cross-cutting invariants (clear ownership, single control gate, Git as single source of truth). + +## Key Features + +- **Declarative Git-Native Modeling**: Ontology definitions are managed in YAML and reviewed via Pull Requests, eliminating opaque UI configuration. +- **Lightweight Single-Process Kernel**: `ontogeny serve` integrates registry, query engine, and Action runtime on SQLite or PostgreSQL. +- **Agent Governance**: Exposes a governed MCP tool surface at `/mcp`. Agents and human users share unified policies, and writes support human approval gates. +- **Deterministic Self-Evolution (RSI)**: Closed-loop cycle of observation → mutation (LLM-assisted DSL diffs) → selection (rule-based deterministic evaluations) → release. +- **Immutable Audit Stream**: Every tool invocation and policy block is recorded for full traceability and replay. +- **Bilingual Web Console**: Built with React 19, offering an interactive ontology canvas, graph explorer, action executor, audit viewer, and evolution panel. + +The ontology canvas provides a comprehensive view of domain objects, relations, actions, and functions, highlighting dependencies on hover: + + + +## Quick Start + +```bash {tab="Docker (Recommended)"} +git clone -b ontogeny https://github.com/apache/hugegraph-ai.git +cd hugegraph-ai/ontogeny + +# Start self-contained demo environment (SQLite + seeded data) +docker compose up -d + +# Optional profiles: +# docker compose --profile postgres up -d Review Comment: Important: neither profile moves Ontogeny off SQLite: compose defaults `ONTOGENY_DB_DSN` to SQLite and the image installs only `.[mcp]` without `asyncpg`, and no `HUGEGRAPH_URL` reaches the container, so `storage_provider` stays `sqlite`. Say that each profile only starts the extra container and name the step that connects it, in EN and in CN, where line 44 reads as running on Postgres or HugeGraph. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
