# singnet/omega architecture

> Architecture diagram of the GitHub repository singnet/omega, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/singnet/omega
- Repository: https://github.com/singnet/omega

## Overview

Omega is documented as a stateful neural-symbolic agent, with this tree exposing its Python integration layers rather than the MeTTa execution loop. The principal user workflow is a message arriving through a configured channel, being handled by the agent runtime, and receiving a response using a selected LLM provider. Supporting branches include authentication, retrieval-backed knowledge, memory portability, and OpenClaw integration. Edges reflect the shown channel/provider registries, imports, and explicit README workflow; the central agent loop and some subsystem wiring are not present in the sampled files.

Main entry points: [`src/channels.py`](https://github.com/singnet/omega/blob/main/src/channels.py) (Channel registry), [`providers/lib_llm_ext.py`](https://github.com/singnet/omega/blob/main/providers/lib_llm_ext.py) (LLM client layer), [`src/providers.py`](https://github.com/singnet/omega/blob/main/src/providers.py) (Provider registry), [`src/memory_export.py`](https://github.com/singnet/omega/blob/main/src/memory_export.py) (Memory portability)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_communication["Communication"]
  node_channel_api["Channel registry<br/>[channels.py]"]
  node_auth["Channel authentication<br/>[auth.py]"]
  node_irc["IRC channel<br/>[irc.py]"]
  node_telegram["Telegram channel<br/>[telegram.py]"]
  node_slack["Slack channel<br/>[slack.py]"]
  node_mattermost["Mattermost channel<br/>[mattermost.py]"]
  node_websocket["WebSocket chat<br/>[wschat.py]"]
  node_delivery["Delivery queue<br/>[delivery_queue.py]"]
end

subgraph group_reasoning["Model and knowledge"]
  node_agent_loop["Omega agent loop"]
  node_provider_registry["Provider registry<br/>[providers.py]"]
  node_llm_core["LLM client layer<br/>[lib_llm_ext.py]"]
  node_openai["OpenAI provider<br/>[openai.py]"]
  node_openrouter["OpenRouter provider<br/>[openrouter.py]"]
  node_asione["ASI:One provider<br/>[asione.py]"]
  node_openai_api["Custom OpenAI API<br/>[openaiapi.py]"]
  node_rag["Knowledge retrieval<br/>[rag.py]"]
  node_chroma[("Vector store")]
  node_embedding_models["Embedding selection"]
end

subgraph group_state["Memory and policy"]
  node_memory_export["Memory portability<br/>[memory_export.py]"]
  node_memory_files[("Memory files<br/>[fileio.py]")]
  node_policy["Profile policy<br/>[policy.py]"]
end

subgraph group_extensions["Extensions and operations"]
  node_config["Configuration<br/>[config.py]"]
  node_plugin_loader["Plugin framework<br/>[plugin.py]"]
  node_openclaw["OpenClaw integration<br/>[openclaw.py]"]
  node_websearch["Web search<br/>[websearch.py]"]
  node_helper["Agent utilities<br/>[helper.py]"]
end

node_user(("Agent user"))
node_llm_service(("LLM services"))

node_user -->|"messages"| node_irc
node_user -->|"messages"| node_telegram
node_irc -->|"registers channel"| node_channel_api
node_telegram -->|"registers channel"| node_channel_api
node_slack -->|"registers channel"| node_channel_api
node_mattermost -->|"registers channel"| node_channel_api
node_websocket -->|"implements interface"| node_channel_api
node_channel_api -->|"checks identity"| node_auth
node_irc -->|"checks authorization"| node_auth
node_telegram -->|"checks authorization"| node_auth
node_slack -->|"checks authorization"| node_auth
node_mattermost -->|"checks authorization"| node_auth
node_irc -->|"uses queue"| node_delivery
node_telegram -->|"uses queue"| node_delivery
node_slack -->|"uses queue"| node_delivery
node_mattermost -->|"uses queue"| node_delivery
node_channel_api -.->|"receives messages"| node_agent_loop
node_agent_loop -->|"sends replies"| node_channel_api
node_agent_loop -->|"requests completion"| node_provider_registry
node_provider_registry -->|"registers provider"| node_openai
node_provider_registry -->|"registers provider"| node_openrouter
node_provider_registry -->|"registers provider"| node_asione
node_provider_registry -->|"registers provider"| node_openai_api
node_openai -->|"delegates chat"| node_llm_core
node_openrouter -->|"delegates chat"| node_llm_core
node_asione -->|"uses client layer"| node_llm_core
node_openai_api -->|"uses client layer"| node_llm_core
node_llm_core -->|"calls API"| node_llm_service
node_agent_loop -.->|"queries knowledge"| node_rag
node_rag -->|"stores and queries"| node_chroma
node_rag -->|"selects model"| node_embedding_models
node_channel_api -->|"routes export command"| node_memory_export
node_memory_export -->|"reads and writes"| node_memory_files
node_agent_loop -.->|"applies policy"| node_policy
node_agent_loop -.->|"invokes integration"| node_openclaw
node_agent_loop -.->|"uses search"| node_websearch
node_openclaw -->|"reads settings"| node_config
node_rag -->|"uses embedding helpers"| node_llm_core
node_memory_export -->|"reads settings"| node_config
node_memory_export -->|"uses model settings"| node_embedding_models
node_memory_export -->|"uses utilities"| node_helper

click node_channel_api "https://github.com/singnet/omega/blob/main/src/channels.py"
click node_auth "https://github.com/singnet/omega/blob/main/channels/auth.py"
click node_irc "https://github.com/singnet/omega/blob/main/channels/irc.py"
click node_telegram "https://github.com/singnet/omega/blob/main/channels/telegram.py"
click node_slack "https://github.com/singnet/omega/blob/main/channels/slack.py"
click node_mattermost "https://github.com/singnet/omega/blob/main/channels/mattermost.py"
click node_websocket "https://github.com/singnet/omega/blob/main/channels/wschat.py"
click node_delivery "https://github.com/singnet/omega/blob/main/channels/delivery_queue.py"
click node_provider_registry "https://github.com/singnet/omega/blob/main/src/providers.py"
click node_llm_core "https://github.com/singnet/omega/blob/main/providers/lib_llm_ext.py"
click node_openai "https://github.com/singnet/omega/blob/main/providers/openai.py"
click node_openrouter "https://github.com/singnet/omega/blob/main/providers/openrouter.py"
click node_asione "https://github.com/singnet/omega/blob/main/providers/asione.py"
click node_openai_api "https://github.com/singnet/omega/blob/main/providers/openaiapi.py"
click node_rag "https://github.com/singnet/omega/blob/main/src/rag.py"
click node_embedding_models "https://github.com/singnet/omega/blob/main/src/embedding_models.py"
click node_memory_export "https://github.com/singnet/omega/blob/main/src/memory_export.py"
click node_memory_files "https://github.com/singnet/omega/blob/main/src/fileio.py"
click node_policy "https://github.com/singnet/omega/blob/main/profile/policy.py"
click node_config "https://github.com/singnet/omega/blob/main/src/config.py"
click node_plugin_loader "https://github.com/singnet/omega/blob/main/src/plugin.py"
click node_openclaw "https://github.com/singnet/omega/blob/main/plugins/openclaw/openclaw.py"
click node_websearch "https://github.com/singnet/omega/blob/main/src/websearch.py"
click node_helper "https://github.com/singnet/omega/blob/main/src/helper.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_channel_api,node_auth,node_irc,node_telegram,node_slack,node_mattermost,node_websocket,node_delivery,node_user toneBlue
class node_agent_loop,node_provider_registry,node_llm_core,node_openai,node_openrouter,node_asione,node_openai_api,node_rag,node_chroma,node_embedding_models toneAmber
class node_memory_export,node_memory_files,node_policy toneMint
class node_config,node_plugin_loader,node_openclaw,node_websearch,node_helper toneRose
class node_llm_service toneIndigo
```

## Components

### Communication

- [Channel registry](https://github.com/singnet/omega/blob/main/src/channels.py): `src/channels.py`
- [Channel authentication](https://github.com/singnet/omega/blob/main/channels/auth.py): `channels/auth.py`
- [IRC channel](https://github.com/singnet/omega/blob/main/channels/irc.py): `channels/irc.py`
- [Telegram channel](https://github.com/singnet/omega/blob/main/channels/telegram.py): `channels/telegram.py`
- [Slack channel](https://github.com/singnet/omega/blob/main/channels/slack.py): `channels/slack.py`
- [Mattermost channel](https://github.com/singnet/omega/blob/main/channels/mattermost.py): `channels/mattermost.py`
- [WebSocket chat](https://github.com/singnet/omega/blob/main/channels/wschat.py): `channels/wschat.py`
- [Delivery queue](https://github.com/singnet/omega/blob/main/channels/delivery_queue.py): `channels/delivery_queue.py`

### Model and knowledge

- **Omega agent loop**
- [Provider registry](https://github.com/singnet/omega/blob/main/src/providers.py): `src/providers.py`
- [LLM client layer](https://github.com/singnet/omega/blob/main/providers/lib_llm_ext.py): `providers/lib_llm_ext.py`
- [OpenAI provider](https://github.com/singnet/omega/blob/main/providers/openai.py): `providers/openai.py`
- [OpenRouter provider](https://github.com/singnet/omega/blob/main/providers/openrouter.py): `providers/openrouter.py`
- [ASI:One provider](https://github.com/singnet/omega/blob/main/providers/asione.py): `providers/asione.py`
- [Custom OpenAI API](https://github.com/singnet/omega/blob/main/providers/openaiapi.py): `providers/openaiapi.py`
- [Knowledge retrieval](https://github.com/singnet/omega/blob/main/src/rag.py): `src/rag.py`
- **Vector store**
- [Embedding selection](https://github.com/singnet/omega/blob/main/src/embedding_models.py): `src/embedding_models.py`

### Memory and policy

- [Memory portability](https://github.com/singnet/omega/blob/main/src/memory_export.py): `src/memory_export.py`
- [Memory files](https://github.com/singnet/omega/blob/main/src/fileio.py): `src/fileio.py`
- [Profile policy](https://github.com/singnet/omega/blob/main/profile/policy.py): `profile/policy.py`

### Extensions and operations

- [Configuration](https://github.com/singnet/omega/blob/main/src/config.py): `src/config.py`
- [Plugin framework](https://github.com/singnet/omega/blob/main/src/plugin.py): `src/plugin.py`
- [OpenClaw integration](https://github.com/singnet/omega/blob/main/plugins/openclaw/openclaw.py): `plugins/openclaw/openclaw.py`
- [Web search](https://github.com/singnet/omega/blob/main/src/websearch.py): `src/websearch.py`
- [Agent utilities](https://github.com/singnet/omega/blob/main/src/helper.py): `src/helper.py`

### Other components

- **Agent user**
- **LLM services**

## Connections

- Agent user → IRC channel: messages (evidence: `README.md`)
- Agent user → Telegram channel: messages (evidence: `README.md`)
- IRC channel → Channel registry: registers channel (evidence: `channels/irc.py`)
- Telegram channel → Channel registry: registers channel (evidence: `channels/telegram.py`)
- Slack channel → Channel registry: registers channel (evidence: `channels/slack.py`)
- Mattermost channel → Channel registry: registers channel (evidence: `channels/mattermost.py`)
- WebSocket chat → Channel registry: implements interface (evidence: `channels/wschat.py`)
- Channel registry → Channel authentication: checks identity (evidence: `src/channels.py`)
- IRC channel → Channel authentication: checks authorization (evidence: `channels/irc.py`)
- Telegram channel → Channel authentication: checks authorization (evidence: `channels/telegram.py`)
- Slack channel → Channel authentication: checks authorization (evidence: `channels/slack.py`)
- Mattermost channel → Channel authentication: checks authorization (evidence: `channels/mattermost.py`)
- IRC channel → Delivery queue: uses queue (evidence: `channels/irc.py`)
- Telegram channel → Delivery queue: uses queue (evidence: `channels/telegram.py`)
- Slack channel → Delivery queue: uses queue (evidence: `channels/slack.py`)
- Mattermost channel → Delivery queue: uses queue (evidence: `channels/mattermost.py`)
- Channel registry → Omega agent loop: receives messages
- Omega agent loop → Channel registry: sends replies (evidence: `README.md`)
- Omega agent loop → Provider registry: requests completion (evidence: `README.md`)
- Provider registry → OpenAI provider: registers provider (evidence: `providers/openai.py`)
- Provider registry → OpenRouter provider: registers provider (evidence: `providers/openrouter.py`)
- Provider registry → ASI:One provider: registers provider (evidence: `providers/asione.py`)
- Provider registry → Custom OpenAI API: registers provider (evidence: `providers/openaiapi.py`)
- OpenAI provider → LLM client layer: delegates chat (evidence: `providers/openai.py`)
- OpenRouter provider → LLM client layer: delegates chat (evidence: `providers/openrouter.py`)
- ASI:One provider → LLM client layer: uses client layer (evidence: `providers/asione.py`)
- Custom OpenAI API → LLM client layer: uses client layer (evidence: `providers/openaiapi.py`)
- LLM client layer → LLM services: calls API (evidence: `providers/lib_llm_ext.py`)
- Omega agent loop → Knowledge retrieval: queries knowledge
- Knowledge retrieval → Vector store: stores and queries (evidence: `src/rag.py`)
- Knowledge retrieval → Embedding selection: selects model (evidence: `src/rag.py`)
- Channel registry → Memory portability: routes export command (evidence: `src/channels.py`)
- Memory portability → Memory files: reads and writes (evidence: `src/memory_export.py`)
- Omega agent loop → Profile policy: applies policy
- Omega agent loop → OpenClaw integration: invokes integration
- Omega agent loop → Web search: uses search
- OpenClaw integration → Configuration: reads settings (evidence: `plugins/openclaw/openclaw.py`)
- Knowledge retrieval → LLM client layer: uses embedding helpers (evidence: `src/rag.py`)
- Memory portability → Configuration: reads settings (evidence: `src/memory_export.py`)
- Memory portability → Embedding selection: uses model settings (evidence: `src/memory_export.py`)
- Memory portability → Agent utilities: uses utilities (evidence: `src/memory_export.py`)
