How rafaelssenna/brain works
brAIn is an online-learning, embodied brain-like AI: it learns perceptions and language from experience rather than relying on a fixed pretrained model. The main user workflow is to show or discuss scenes, receive answers grounded in what the agent perceives, and teach it through feedback; separate workflows support adaptive lessons and learning from web text. The README documents additional cognitive capabilities across prediction, memory, planning, vision, language, and reasoning. Those capabilities are grouped by role; unsampled module wiring is not inferred.
Main entry points: conversa.py Portuguese conversation · agent.py Living agent · integrated.py Integrated organism · professor.py Adaptive lessons
Components 21
Interaction and learning
- Simple-world chat
chat.py - Portuguese conversation
conversa.py - Adaptive lessons
professor.py
Embodied cognition
- Living agent
src/brain/agent.py - Spiking neurons
src/brain/neuron.py - Plastic synapses
src/brain/synapse.py - Embodied world
src/brain/world.py - Integrated organism
src/brain/integrated.py - Predictive coding
src/brain/predictive.py - Memory and replay
src/brain/memory.py - Visual perception
src/brain/rich_world.py - Imaginative planning
src/brain/planning.py
Language and reasoning
- Language capabilities
src/brain/communication.py - Contextual dialogue
src/brain/conversation.py - Reasoning
src/brain/reasoning.py
Reading and memory
- Reading brain
src/brain/reading.py - Web access
src/brain/web.py - Saved brain state
src/brain/agent.py
Other components
- Learner
- Scene
- Wikipedia PT
Connections 26
- Learner → Simple-world chat: teaches or asks
- Scene → Simple-world chat: supplies scene
- Simple-world chat → Living agent: perceives and learns
- Living agent → Simple-world chat: returns naming
- Learner → Portuguese conversation: asks or corrects
- Portuguese conversation → Visual perception: perceives scene
- Portuguese conversation → Contextual dialogue: handles turns
- Portuguese conversation → Reading brain: queries learned text
- Adaptive lessons → Portuguese conversation: conducts lessons
- Adaptive lessons → Visual perception: selects objects
- Adaptive lessons → Saved brain state: loads and saves
- Living agent → Spiking neurons: uses spiking substrate
- Living agent → Plastic synapses: learns by plasticity
- Living agent → Embodied world: acts in environment
- Integrated organism → Predictive coding: combines prediction
- Integrated organism → Memory and replay: combines memory
- Integrated organism → Imaginative planning: combines planning
- Integrated organism → Language capabilities: co-emerges language
- Integrated organism → Visual perception: integrates perception
- Portuguese conversation → Reasoning: answers reasoning queries
- Learner → Adaptive lessons: starts study
- Wikipedia PT → Web access: provides articles
- Web access → Reading brain: fetches text
- Reading brain → Saved brain state: persists knowledge
- Reading brain → Portuguese conversation: provides learned associations
- Living agent → Saved brain state: saves and loads