https://github.com/aygp-dr/frames-explorer
A Python implementation of frame-based knowledge representation systems inspired by Marvin Minsky's Society of Mind. Features slots, facets, demons, and inheritance for building intelligent systems.
https://github.com/aygp-dr/frames-explorer
ai cognitive-science frames knowledge-representation minsky python semantic-networks society-of-mind
Last synced: 2 months ago
JSON representation
A Python implementation of frame-based knowledge representation systems inspired by Marvin Minsky's Society of Mind. Features slots, facets, demons, and inheritance for building intelligent systems.
- Host: GitHub
- URL: https://github.com/aygp-dr/frames-explorer
- Owner: aygp-dr
- Created: 2025-06-11T00:08:48.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-11T08:03:00.000Z (4 months ago)
- Last Synced: 2025-06-19T20:11:39.436Z (4 months ago)
- Topics: ai, cognitive-science, frames, knowledge-representation, minsky, python, semantic-networks, society-of-mind
- Language: Python
- Size: 1.25 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Frame-Based Knowledge Representation Workshop
A modern Python implementation of frame-based knowledge representation inspired by MIT's FRL (Frame Representation Language) from the 1970s.
## System Architecture
```mermaid
classDiagram
class Frame {
+string name
+Dict slots
+Dict _frames
+add_slot()
+get()
+put()
+remove_slot()
+describe()
+to_dict()
}
class FRL_API {
+fassert()
+fget()
+fput()
+fdel()
}
class Persistence {
+save_frames()
+load_frames()
}
class Slot {
+value
+default
+if_needed
+if_added
+if_removed
+units
}
Frame "1" -- "*" Slot : contains
FRL_API -- Frame : manipulates
Persistence -- Frame : serializes
```
## Features
- **Frames**: Knowledge structures with slots and facets
- **Computed Values**: Lazy evaluation with `if_needed`
- **Active Values (Demons)**: Triggers on value changes
- **Prototype Inheritance**: Share knowledge between frames
- **Persistence**: Save/load frames as JSON
- **Cross-Platform**: Works on Linux, FreeBSD, macOS, and in containers
## Quick Start
```bash
# Clone the repository
git clone https://github.com/aygp-dr/frames-explorer.git
cd frames-explorer
# Set up development environment (optional)
make init
# Run interactive examples
python3 examples.py
# Or run tests
python3 test_frames.py
```
## Basic Usage
```python
from frame_system import fassert, fget, fput
# Create a frame
robot = fassert('my-robot',
type={'value': 'service-robot'},
height={'value': 1.5, 'units': 'meters'},
battery={'value': 85, 'units': 'percent'}
)
# Access values
print(fget('my-robot', 'height')) # 1.5
print(fget('my-robot', 'height', 'units')) # meters
# Update values
fput('my-robot', 'battery', 75)
```
## Examples
Run the examples to see various features:
```python
python3 examples.py
# Then try: example_basic(), example_demons(), etc.
```
## Testing
Run the test suite:
```bash
python3 test_frames.py
```
## Platform Compatibility
Tested on:
- Linux x86_64 (Debian)
- Linux ARM64 (Raspberry Pi)
- FreeBSD 14.2-RELEASE (amd64)
- Alpine Linux (Docker)
## License
This project is licensed under the MIT License - see the LICENSE file for details.
## Reading List
This implementation is based on foundational work in frame-based knowledge representation:
- Marvin Minsky (1974): [A Framework for Representing Knowledge](https://dspace.mit.edu/handle/1721.1/6089). AIM-306, Cambridge, US: MIT.
- R. Bruce Roberts and Ira P. Goldstein (1977): [FRL Primer](https://dspace.mit.edu/handle/1721.1/5767). AIM-408, Cambridge, US: MIT.
- R. Bruce Roberts and Ira P. Goldstein (1977): [FRL Manual](https://dspace.mit.edu/handle/1721.1/5768). AIM-409, Cambridge, US: MIT.
- Marvin Minsky (1986): [The Society of Mind](https://en.wikipedia.org/wiki/Society_of_Mind). Simon & Schuster.
## Credits
Inspired by FRL (Frame Representation Language) from MIT AI Lab, 1970s.
Modern implementation by aygp-dr.