TODO-OC.md.backup_20250929_210835

## The OpenCog Project 👋
[OpenCog aims to create AGI](https://wiki.opencog.org/w/The_Open_Cognition_Project)
with a combination of exploration, engineering and basic science research.
Side quests have included robotics systems ([Hanson Robotics](https://www.hansonrobotics.com)),
financial systems (Aidiya),
genomics (MOZI and [Rejuve.bio](https://www.rejuve.bio)),
machine learning ([predicting risk from clinician notes](https://doi.org/10.1371/journal.pone.0085733)),
natural language chatbots ([virtual dog playing fetch](https://www.youtube.com/watch?v=FEmpGRLwbqE)) and more.
This project was pioneered by [Dr. Ben Goertzel](https://en.wikipedia.org/wiki/Ben_Goertzel).

https://github.com/orgs/opencog/repositories?type=all

Git repos fall into four categories:

### OpenCog AtomSpace
The core of the system. As of 2025, it is active, stable and supported.

* [atomspace](https://github.com/opencog/atomspace) - The OpenCog (hyper-)graph database and graph rewriting system
* [atomspace-ipfs](https://github.com/opencog/atomspace-ipfs) - IPFS backend to the AtomSpace Graph Database
* [atomspace-dht](https://github.com/opencog/atomspace-dht) - OpenDHT backend driver for the AtomSpace Graph Database
* [atomspace-websockets](https://github.com/opencog/atomspace-websockets) - A websocket server to access AtomSpace - https://github.com/opencog/atomspace
* [atomspace-restful](https://github.com/opencog/atomspace-restful) - RESTful web server for the AtomSpace Graph Database
* [atomspace-cog](https://github.com/opencog/atomspace-cog) - Distributed AtomSpace Network client
* [atomspace-rocks](https://github.com/opencog/atomspace-rocks) - AtomSpace Graph Database RocksDB backend
* [atomspace-agents](https://github.com/opencog/atomspace-agents) - Policy agents for moving Atoms between disk and RAM and network
* [atomspace-rpc](https://github.com/opencog/atomspace-rpc) - A gRPC server and client to execute pattern matching queries
* [atomspace-explorer](https://github.com/opencog/atomspace-explorer) - Proof-of-concept visualizer for the AtomSpace
* [atomspace-js](https://github.com/opencog/atomspace-js) - Javascript bindings to the AtomSpace
* [atomspace-typescript](https://github.com/opencog/atomspace-typescript) - Typescript (javascript) API into the AtomSpace
* [atomspace-bridge](https://github.com/opencog/atomspace-bridge) - Read/write interfaces between AtomSpace and SQL databases.
* [atomspace-metta](https://github.com/opencog/atomspace-metta) - MeTTa on top of AtomSpace
* [atomspace-pgres](https://github.com/opencog/atomspace-pgres) - Postgres StorageNode for the AtomSpace
* [atomspace-storage](https://github.com/opencog/atomspace-storage) - AtomSpace StorageNode base system

### OpenCog Fossils
Older, abandoned and obsolete components and experiments. These were attempts to build subsystems 
with specific goals and ideas in mind. As experiments, they provided validation for certain design
ideas. They were educational and fun, but turned out to be unworkable. Thus, development has
halted. These projects are no longer maintained. They do contain useful subsystems that could be
salvaged for future use. This includes:
* [unity3d-opencog-game](https://github.com/opencog/unity3d-opencog-game) - A Unity3D game world for OpenCog-controlled agents
* [linkgrammar-relex-web](https://github.com/opencog/linkgrammar-relex-web) - A Web UI for LinkGrammar and RelEx
* [ros_opencog_robot_embodiment](https://github.com/opencog/ros_opencog_robot_embodiment) - No description available
* [rest-api-documentation](https://github.com/opencog/rest-api-documentation) - OpenCog REST API interactive documentation, generated by Swagger and hosted on GitHub Pages.
* [python-client](https://github.com/opencog/python-client) - Defines a Python client API to allow OpenCog experiments to be written as short Python scripts.
* [python-destin](https://github.com/opencog/python-destin) - Python implementation of the DeSTIN deep learning perception system using the Theano library
* [opencog-neo4j](https://github.com/opencog/opencog-neo4j) - Google Summer of Code 2015 Proposal to implement Neo4j Graph Backing Store as described in http:/...
* [opencog-to-minecraft](https://github.com/opencog/opencog-to-minecraft) - Interface linking Minecraft to OpenCog using ROS
* [language-learning](https://github.com/opencog/language-learning) - OpenCog Unsupervised Language Learning
* [pattern-index](https://github.com/opencog/pattern-index) - Fast indexes for the AtomSpace
* [dimensional-embedding](https://github.com/opencog/dimensional-embedding) - Dimensional Embedding Clustering
* [visualization](https://github.com/opencog/visualization) - Visualizing the contents of the AtomSpace
* [python-attic](https://github.com/opencog/python-attic) - Archive of old opencog python code

### OpenCog Incubator
These are the immature, incomplete, promising projects that haven't taken off yet.

* [opencog](https://github.com/opencog/opencog) - A framework for integrated Artificial Intelligence & Artificial General Intelligence (AGI)
* [ocpkg](https://github.com/opencog/ocpkg) - Installing, packaging, deploying and managing OpenCog
* [destin](https://github.com/opencog/destin) - Deep SpatioTemporal Inference Network (DeSTIN) for vision processing
* [test-datasets](https://github.com/opencog/test-datasets) - Reference AtomSpace files for testing and development
* [external-tools](https://github.com/opencog/external-tools) - External, stand-alone tools that work with OpenCog
* [relex](https://github.com/opencog/relex) - English Dependency Relationship Extractor
* [docker](https://github.com/opencog/docker) - Docker containers for OpenCog - Robot Operating System (ROS)
* [link-grammar](https://github.com/opencog/link-grammar) - The CMU Link Grammar natural language parser
* [agi-bio](https://github.com/opencog/agi-bio) - Genomic and Proteomic data exploration and pattern mining
* [ros-behavior-scripting](https://github.com/opencog/ros-behavior-scripting) - Hanson Robotics Eva robot sensory and motor API
* [moses](https://github.com/opencog/moses) - MOSES Machine Learning: Meta-Optimizing Semantic Evolutionary Search. See also AS-MOSES https://g...
* [cogutil](https://github.com/opencog/cogutil) - Very low-level C++ programming utilities used by several components
* [opencog.org](https://github.com/opencog/opencog.org) - Page Sources & Configuration Files for opencog.org
* [tv-toolbox](https://github.com/opencog/tv-toolbox) - ToolBox to experiment with different TruthValue types
* [pi_vision](https://github.com/opencog/pi_vision) - Pi Vision ported to ROS Noetic
* [perception](https://github.com/opencog/perception) - Perception synthesizer
* [blender_api_msgs](https://github.com/opencog/blender_api_msgs) - ROS node for blender_api
* [blender_api](https://github.com/opencog/blender_api) - Eva Blender Animation API
* [robots_config](https://github.com/opencog/robots_config) - Robot configuration files
* [pau2motors](https://github.com/opencog/pau2motors) - ROS node converts PAU (Physiological Action Unit) messages to motor commands.
* [loving-ai](https://github.com/opencog/loving-ai) - No description available
* [guile-dbi](https://github.com/opencog/guile-dbi) - Guile Scheme SQL database interfaces
* [TinyCog](https://github.com/opencog/TinyCog) - Small Robot, Toy Robot platform
* [semantic-vision](https://github.com/opencog/semantic-vision) - Official repository for the semantic vision research initiative using SynerGAN.
* [opencog_rpi](https://github.com/opencog/opencog_rpi) - Opencog Cross Compile Toolchain for Raspberry Pi3
* [asmoses](https://github.com/opencog/asmoses) - MOSES Machine Learning: Meta-Optimizing Semantic Evolutionary Search for the AtomSpace (https://g...
* [benchmark](https://github.com/opencog/benchmark) - Benchmarking the AtomSpace, the pattern matcher and other OpenCog systems
* [loving-ai-ghost](https://github.com/opencog/loving-ai-ghost) - A port of the [OpenCog's loving-ai ChatScripts](https://github.com/opencog/loving-ai) to Ghost.  ...
* [ghost_bridge](https://github.com/opencog/ghost_bridge) - A ROS bridge between the Hanson Robotics stack and OpenCog's GHOST
* [stochastic-language-generation](https://github.com/opencog/stochastic-language-generation) - No description available
* [opencog-nix](https://github.com/opencog/opencog-nix) - Build definitions for the NIX package manager
* [opencog-debian](https://github.com/opencog/opencog-debian) - OpenCog packaging-related files for Debian / Ubuntu
* [learn](https://github.com/opencog/learn) - Neuro-symbolic interpretation learning (mostly just language-learning, for now)
* [ure](https://github.com/opencog/ure) - [NO LONGER MAINTAINED, SUPERSEDED BY https://github.com/trueagi-io/chaining]. Unified Rule Engine...
* [miner](https://github.com/opencog/miner) - Frequent and surprising subhypergraph pattern miner for the AtomSpace.
* [spacetime](https://github.com/opencog/spacetime) - Save, track and query 3D+time locations of objects in the AtomSpace
* [distributional-value](https://github.com/opencog/distributional-value) - Distributional Value as described in https://github.com/opencog/atomspace/issues/833
* [attention](https://github.com/opencog/attention) - OpenCog Attention Allocation Subsystem
* [cogserver](https://github.com/opencog/cogserver) - Distributed AtomSpace Network Server
* [pln](https://github.com/opencog/pln) - [NO LONGER MAINTAINED, SUPERSEDED BY https://github.com/trueagi-io/pln-experimental and https://g...
* [generate](https://github.com/opencog/generate) - Generate networks from syntax (e.g. natural language, math proofs, action plans, biome/reactome n...
* [rocca](https://github.com/opencog/rocca) - Rational OpenCog Controlled Agent (ROCCA). Use OpenCog to control a rational agent in OpenAI Gym ...
* [pln-brca-xp](https://github.com/opencog/pln-brca-xp) - Apply PLN to the breast-cancer dataset
* [lg-atomese](https://github.com/opencog/lg-atomese) - Atomese API for Link Grammar
* [vision](https://github.com/opencog/vision) - Atomese wrappers around a subset of OpenCV
* [cogprotolab](https://github.com/opencog/cogprotolab) - AtomSpace visualizer
* [logicmoo_cogserver](https://github.com/opencog/logicmoo_cogserver) - Logicmoo server presenting a CogServer-compatible network interface
* [cheminformatics](https://github.com/opencog/cheminformatics) - Molecular Chemistry
* [unify](https://github.com/opencog/unify) - Atomese expression unifier
* [opencog-cycl](https://github.com/opencog/opencog-cycl) - A transcription of CycL to Atomese
* [link-grammar-website](https://github.com/opencog/link-grammar-website) - Copy of last working version of link-grammar website
* [.github](https://github.com/opencog/.github) - Intended to hold the public profile README
* [sensory](https://github.com/opencog/sensory) - Low-level sensory I/O Atoms
* [agents](https://github.com/opencog/agents) - Experiments with Agents
* [motor](https://github.com/opencog/motor) - Sensorimotor research
* [atomese-simd](https://github.com/opencog/atomese-simd) - Atomese to OpenCL/CUDA (GPU/compute) I/O Channel
* [matrix](https://github.com/opencog/matrix) - AtomSpace Graph Sparse Vector Library
* [evidence](https://github.com/opencog/evidence) - Hierarchical similarity and evidence-gathering


## Integration with ElizaOS

### Cross-Ecosystem Components
OpenCog components can be integrated into ElizaOS as plugins and subsystems:

#### AtomSpace Integration
- **atomspace-python**: Python bindings for AtomSpace integration into ElizaOS agents
- **atomspace-js**: JavaScript/TypeScript bindings for web-based ElizaOS clients
- **cogserver-connector**: ElizaOS plugin for CogServer communication

#### Reasoning Integration  
- **pln-agent**: ElizaOS agent wrapper for PLN reasoning
- **pattern-matcher**: ElizaOS action for AtomSpace pattern matching
- **query-engine**: ElizaOS service for Atomese queries

#### Language Processing
- **link-grammar-plugin**: ElizaOS plugin for syntactic parsing
- **nlp-pipeline**: ElizaOS action chain for OpenCog NLP processing

### Implementation Roadmap
- [ ] Create Python binding layer for core AtomSpace in ElizaOS
- [ ] Implement CogServer connector plugin
- [ ] Design distributed reasoning coordination
- [ ] Build Atomese query interface for ElizaOS
- [ ] Create OpenCog agent templates for ElizaOS
- [ ] Implement hypergraph visualization for ElizaOS dashboard

## GnuCash Integration

### Hybrid Fractal Financial Structure
Integrating GnuCash financial management with cognitive architectures:

#### OpenCog Financial Reasoning
- **financial-atomspace**: Represent financial data as Atoms and Links
- **accounting-rules**: PLN rules for financial pattern recognition
- **transaction-analysis**: Cognitive analysis of spending patterns
- **budget-prediction**: AI-driven budget forecasting

#### ElizaOS Financial Agents
- **expense-tracker**: ElizaOS agent for automatic expense categorization
- **investment-advisor**: AI agent for investment recommendations
- **financial-alerts**: Smart notification system for financial events
- **budget-assistant**: Conversational budget planning agent

### Fractal Architecture
```
GnuCash (Financial Data)
├── OpenCog Layer (Cognitive Reasoning)
│   ├── AtomSpace (Knowledge Representation)
│   ├── PLN (Logical Reasoning)
│   └── Pattern Recognition
└── ElizaOS Layer (Agent Interactions)
    ├── Financial Agents
    ├── User Interfaces
    └── Multi-Agent Coordination
```


# HELP WANTED

## Development Priorities

### Core Infrastructure
- AtomSpace performance optimization
- Distributed processing enhancements  
- Cross-language binding improvements
- Integration testing frameworks

### Research Areas
- Hyperon-AtomSpace compatibility layers
- Advanced reasoning algorithms
- Multi-modal learning systems
- Real-time cognitive architectures

### Integration Projects
- ElizaOS-OpenCog bridge development
- GnuCash cognitive enhancement
- Financial reasoning frameworks
- Hybrid agent architectures

### Commercial support
If you are a commercial business looking to use any of these components in your products,
we can provide full-time support, if that's what you want. We'll custom-taylor components,
systems, and API's to suit your needs. If you are an investor looking to build up a venture,
well yes, that could happen too. Talk to us. Contact [Linas Vepstas](linasvepstas@gmail.com).