| title | Cognitive Modeling Framework | |||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| type | overview | |||||||||||||||||
| status | stable | |||||||||||||||||
| created | 2024-01-01 | |||||||||||||||||
| updated | 2026-01-03 | |||||||||||||||||
| tags |
|
|||||||||||||||||
| semantic_relations |
|
A comprehensive framework for cognitive modeling using Active Inference principles. This repository provides theoretical foundations, practical implementations, and extensive documentation to advance understanding and application of cognitive systems.
Active Inference is a mathematical framework that explains how biological and artificial systems learn, perceive, and act by minimizing prediction errors. This repository provides a unified framework for cognitive modeling that integrates:
- Active Inference Theory: Probabilistic frameworks for perception, action, and learning
- Agent Architectures: Implementations from simple decision-making agents to complex multi-agent systems
- Knowledge Organization: Structured documentation and theoretical foundations
- Implementation Examples: Working code examples across multiple domains
- Development Tools: Utilities for cognitive modeling and analysis
- [[knowledge_base/cognitive/README|Concepts]] - Core theoretical foundations
- [[docs/guides/README|Guides]] - Implementation and usage guides
- [[docs/api/README|API Reference]] - Technical documentation
- [[docs/examples/README|Examples]] - Usage examples and tutorials
- [[docs/agents/README|Agent Documentation]] - Autonomous agent frameworks
- [[knowledge_base/cognitive/README|Cognitive Science]] - Cognitive concepts and theories
- [[knowledge_base/mathematics/README|Mathematics]] - Mathematical foundations
- [[knowledge_base/biology/README|Biology]] - Biological foundations
- [[knowledge_base/systems/README|Systems Theory]] - Systems and complex systems
- [[knowledge_base/agents/README|Agent Architectures]] - Agent design patterns
- [[tools/src/README|Source Code]] - Core implementations
- [[tools/src/models/README|Models]] - Agent and cognitive models
- [[tools/src/visualization/README|Visualization]] - Analysis and plotting tools
- [[tools/src/utils/README|Utilities]] - Helper functions and utilities
- [[code/Things/Generic_Thing/README|Generic Thing]] - Base cognitive agent framework
- [[code/Things/Simple_POMDP/README|Simple POMDP]] - Basic POMDP implementations
- [[code/Things/Generic_POMDP/README|Generic POMDP]] - Extended POMDP framework
- [[code/Things/Continuous_Generic/README|Continuous Generic]] - Continuous state space models
- [[code/Things/Ant_Colony/README|Ant Colony]] - Swarm intelligence implementations
- [[code/Things/BioFirm/README|BioFirm]] - Biological firm theory models
- [[code/Things/Baseball_Game/README|Baseball Game]] - Sports decision-making simulation
- [[code/Things/KG_Multi_Agent/README|KG Multi-Agent]] - Knowledge graph multi-agent system
- [[code/Things/Path_Network/README|Path Network]] - Path network agent
- Unit tests for all components
- Integration tests for system interactions
- Visualization test outputs
- Performance benchmarks
- Python 3.8+ for implementation examples
- Obsidian for optimal documentation navigation
- Git for repository management
# Clone the repository
git clone https://github.com/ActiveInferenceInstitute/cognitive.git
cd cognitive
# Install dependencies for specific implementations
cd code/Things/Generic_Thing
pip install -r requirements.txt
# Run basic tests
python -m pytest code/tests/- Explore Documentation: Start with [[docs/README]] for overview
- Understanding Theory: Read [[knowledge_base/index]] for foundations
- Try Examples: Run implementations in [[code/Things/Generic_Thing/README]]
- Learn Concepts: Follow learning paths in [[docs/guides/learning_paths/README]]
- Active Inference: Unified framework for perception, action, and learning
- Free Energy Principle: Mathematical foundation for self-organizing systems
- Predictive Processing: Hierarchical prediction and error minimization
- Bayesian Methods: Statistical inference and uncertainty quantification
- POMDP Agents: Partially observable Markov decision process implementations
- Continuous Agents: Differential equation-based cognitive models
- Multi-Agent Systems: Coordination and emergent behavior patterns
- Swarm Intelligence: Collective decision-making and stigmergy
- Visualization: State space plots, belief evolution, and network graphs
- Metrics: Performance evaluation and benchmarking utilities
- Simulation: Environment modeling and scenario testing frameworks
- Analysis: Network analysis and pattern recognition tools
- [[docs/guides/README|Implementation Guides]]
- [[knowledge_base/cognitive/active_inference|Active Inference Overview]]
- [[docs/examples/README|Examples and Tutorials]]
- [[docs/research/research_documentation_index|Research Documentation]]
- [[knowledge_base/mathematics/free_energy_principle|Mathematical Foundations]]
- [[docs/implementation/rxinfer/README|RxInfer Framework]]
- [[docs/api/api_documentation|API Reference]]
- [[docs/implementation/implementation_guides|Implementation Guides]]
- [[tools/src/README|Source Code Overview]]
- Cognitive architectures and agent design
- Neural implementation and brain modeling
- Social cognition and multi-agent coordination
- Ecological and evolutionary perspectives
- Robotics and autonomous systems
- Healthcare and medical decision making
- Financial modeling and risk assessment
- Environmental management and sustainability
- Scalable inference algorithms
- Real-time cognitive processing
- Hybrid symbolic-subsymbolic systems
- Cross-domain knowledge integration
- Documentation: Improve or expand the knowledge base
- Implementation: Add new agent architectures or examples
- Research: Contribute theoretical advances or applications
- Testing: Enhance test coverage and validation
- Tools: Develop utilities and analysis tools
- Fork the repository
- Create a feature branch
- Make your changes following [[docs/development/contribution_guide|contribution guidelines]]
- Add tests and documentation
- Submit a pull request
- [[docs/repo_docs/documentation_standards|Documentation Standards]]
- [[docs/repo_docs/ai_file_organization|File Organization]]
- [[docs/repo_docs/naming_conventions|Naming Conventions]]
- [[knowledge_base/linking_standards|Linking Standards]]
- Framework: Active Inference v2.0
- Documentation: Comprehensive coverage with Obsidian integration
- Testing: High coverage across all implementations
- Examples: Multiple working implementations across domains
- RxInfer Integration: Advanced probabilistic programming
- Multi-Agent Systems: Complex coordination mechanisms
- Real-time Processing: Low-latency cognitive architectures
- Cross-Domain Applications: Healthcare, finance, robotics
- Documentation Coverage: 95%+ of concepts documented
- Test Coverage: 85%+ code coverage
- Implementation Examples: 8+ working agent frameworks
- Cross-References: Extensive bidirectional linking
- GitHub: ActiveInferenceInstitute/cognitive
- Discussions: GitHub Discussions for questions and ideas
- Issues: Bug reports and feature requests
- Wiki: Extended documentation and tutorials
- RxInfer.jl: Advanced probabilistic programming for Active Inference
- Active Inference Institute: Research and education initiatives
- BioFirm: Biological firm theory implementations
- [[docs/guides/learning_paths/README|Learning Paths]] - Structured educational content
- [[docs/examples/README|Examples]] - Practical implementations
- [[docs/research/README|Research Documentation]] - Academic foundations
MIT License - See [[LICENSE]] for details
Copyright (c) 2025 Active Inference Institute
CC BY-NC-SA 4.0 - See Creative Commons License
This project is developed by the Active Inference Institute and contributors worldwide. Special thanks to:
- Active Inference Community: For foundational research and ongoing collaboration
- RxInfer Contributors: For advanced probabilistic programming frameworks
- Obsidian Community: For powerful knowledge management tools
- Open Source Contributors: For code, documentation, and research contributions
Navigation Tip: Use Obsidian's graph view and search functionality to explore connections between concepts. The [[docs/agents/agent_docs_readme|Agent Documentation Clearinghouse]] provides comprehensive details on agent implementations.
Note: This repository is designed to work optimally with Obsidian for knowledge management and linking. Many features rely on Obsidian's bidirectional linking and graph visualization capabilities.