feagi-core 2.1.21

Core SDK for building FEAGI agents, controlling the neural engine, and creating marketplace packages (without Brain Visualizer)

FEAGI Python SDK

Build AI agents that learn like biological brains

---

Installation Options

Full Experience (Recommended for most users):

pip install feagi

Includes:

• FEAGI itself, for running neuronal simulations
• Brain Visualizer, for real-time 3D neural activity visualization (~196MB)
• Python bindings for FEAGI libraries (intended for advanced users)
• FEAGI Agent Python SDK for rapidly making agents for FEAGI

Slim/Core (Recommended for Production):

pip install feagi-core

Includes:

• Python bindings for FEAGI libraries (intended for advanced users)
• FEAGI Agent Python SDK for rapidly making agents for FEAGI

Note: Both packages use identical imports (from feagi import ...)

---

What is FEAGI?

FEAGI (Framework for Evolutionary Artificial General Intelligence) is a biologically inspired, modular neural execution engine designed for embodied AI and robotics. FEAGI enables spiking-neural-circuit-driven perception, cognition, and control across simulated and physical embodiments, with a strong emphasis on real-time interaction, modularity, and cross-platform deployment.

FEAGI serves as the core neural runtime behind Neurorobotics Studio, powering a growing ecosystem of reusable neural components ("brains"), tools, and integrations for robotics and physical AI.

The FEAGI Python SDK

The FEAGI Python SDK provides the tools you need to:

• Connect robots and devices to FEAGI's neural network
• Build learning agents for robots, simulators, and games
• Visualize neural activity in real-time with Brain Visualizer
• Control and manage FEAGI from Python code
• Interface with diverse embodiments through standardized communication protocols

---

Key Concepts

• Neuromorphic by Design – FEAGI is built as a neuromorphic framework inspired by biological neural computation. While it currently runs on conventional CPUs and GPUs, native support for neuromorphic hardware is a near-term roadmap item, enabling direct execution on event-driven, spike-based accelerators as they mature.

• Embodied Intelligence First – FEAGI is designed to control bodies (robots, agents, simulations), not just process static data.

• Spiking Neural Networks (SNNs) – Uses event-driven neuron firing rather than frame-based inference.

• Modular Neural Architecture – Neural circuits can be composed like building blocks (Lego-like micro-circuits).

• Real-Time Closed Loop – Continuous perception → cognition → action loop.

• Cross-Simulator & Hardware Support – One brain, many bodies.

---

Quick Start

Get started with FEAGI in just 2 lines:

pip install "feagi"
feagi start 
feagi bv start

That's it! This installs FEAGI with Brain Visualizer, creates default configuration automatically, and launches the visualizer.

Documentation

• Documentation
• Examples

---

Configuration Management

Initialize FEAGI environment with default configuration:

feagi init

This creates:

• Configuration: ~/.feagi/config/feagi_configuration.toml
• Genomes directory: ~/Documents/FEAGI/Genomes/ (macOS/Windows) or ~/FEAGI/genomes/ (Linux)
• Connectomes directory: ~/Documents/FEAGI/Connectomes/ or ~/FEAGI/connectomes/
• Logs and cache directories

For complete configuration options and customization, see DEPLOY.md.

Start FEAGI Engine from Python

from feagi.engine import FeagiEngine

engine = FeagiEngine()
engine.load_config()  # Uses default config
engine.load_genome("my_brain.json")  # Loads from genomes directory
engine.start()

Or from command line:

feagi start --config ~/.feagi/config/feagi_configuration.toml --genome my_brain.json

SDK Architecture

feagi/
├── agent/           # Agent framework (BaseAgent)
├── pns/             # Peripheral Nervous System (communication)
├── engine/          # Engine control
├── config/          # Configuration management
├── paths/           # Cross-platform path utilities
├── cli/             # Command-line tools
├── genome/          # Runtime genome manipulation (coming soon)
├── connectome/      # Brain state management (coming soon)
└── packaging/       # Marketplace packages (coming soon)

Examples

See examples/ for complete agent implementations:

• Basic sensory agent
• Robot agent (SDK-based)
• Simulator agent (Webots)
• Vision processing

---

Community & Support

• Discord: Join our community
• Issues: Report bugs
• Neurorobotics Studio: Cloud platform
• Homepage: feagi.org

---

Requirements

• Python 3.10 or higher
• Works on Linux, macOS, and Windows

---

License

Apache 2.0 - See LICENSE for details.

Copyright 2016-2025 Neuraville Inc. All Rights Reserved.

---

About Neuraville

FEAGI is developed by Neuraville, a company focused on democratizing robotics and enabling the next generation of embodied AI through modular, biologically inspired intelligence systems.