FEAGI Python SDK

Build AI agents that learn like biological brains

PyPI Python Discord License

FEAGI Brain Visualizer: spatial brain view, neural architecture graph, and real-time activity

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 perception, cognition, and control through spiking neural circuits across simulated and physical embodiments, with a strong emphasis on real-time interaction, modularity, and cross-platform deployment.

FEAGI includes a 3D brain visualizer for real-time neural activity and official open source SDKs for Python (this repository), Rust, and Java. Together they support a growing ecosystem of reusable neural components ("brains"), tools, and integrations for robotics and physical AI.

Neurorobotics Studio is FEAGI's desktop application for working with brains, simulations, and embodiments in a unified environment.

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

Quick Start

pip install feagi
feagi start
feagi bv start

That installs the feagi package (engine, Brain Visualizer, and SDK), starts FEAGI with default configuration, and opens the Brain Visualizer. The same flow works on Linux, macOS, and Windows.

Installation

Quick Start uses feagi. If you need a smaller install without Brain Visualizer, use feagi-core instead. Imports are the same for both (from feagi import ...).

Command What you get
pip install feagi Full install: neuronal engine, Brain Visualizer (adds ~196MB of platform binaries), Rust-backed Python bindings, and the agent SDK. Recommended for most users.
pip install feagi-core Engine, bindings, and agent SDK only—no Brain Visualizer. Recommended for production, CI, or headless setups.

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.

Documentation

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

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.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for neuraville from gravatar.com neuraville

Credits

Author: Neuraville Inc.

License

Apache Software License (Apache-2.0)

Requires

Python >=3.10

Provides Extra

bv video bluetooth test dev docs full

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

feagi_core-2.1.43.tar.gz (27.4 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

feagi_core-2.1.43-py3-none-any.whl (27.6 MB view details)

Uploaded Python 3

File details

Details for the file feagi_core-2.1.43.tar.gz.

File metadata

  • Download URL: feagi_core-2.1.43.tar.gz
  • Upload date:
  • Size: 27.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for feagi_core-2.1.43.tar.gz
Algorithm Hash digest
SHA256 7ef0b453a935c99e69b3577d523fbf28a10dc2276feb4a74853bfba9f266fcc3
MD5 e7c8c88442aeca4f82531b01fe9a677a
BLAKE2b-256 512c035d8e7acf26b891d534dce2b0e907ad3cdb4070d63a78d737aa5f67b9e0

See more details on using hashes here.

File details

Details for the file feagi_core-2.1.43-py3-none-any.whl.

File metadata

  • Download URL: feagi_core-2.1.43-py3-none-any.whl
  • Upload date:
  • Size: 27.6 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for feagi_core-2.1.43-py3-none-any.whl
Algorithm Hash digest
SHA256 cb0d7744e083b9d035c2acc20f7fec4d5977af8ad52b4a5ab9c8edede1a6678c
MD5 0ebff159637f080890d523085c7baf72
BLAKE2b-256 329e33b6b9ee9c42c58605984245ca63f657a4f5c878d66e8d58ac08e436c5d5

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

2.1.43 This release

2 files

2.1.42

2 files

2.1.41

2 files

2.1.40

2 files

2.1.39

2 files

2.1.38

2 files

2.1.37

2 files

2.1.36

2 files

2.1.35

2 files

2.1.34

2 files

2.1.33

2 files

2.1.32

2 files

2.1.31

2 files

2.1.30

2 files

2.1.29

2 files

2.1.28

2 files

2.1.27

2 files

2.1.26

2 files

2.1.25

2 files

2.1.24

2 files

2.1.23

2 files

2.1.22

2 files

2.1.21

2 files

2.1.20

2 files

2.1.19

2 files

2.1.17

2 files

2.1.16

2 files

2.1.15

2 files

2.1.14

2 files

2.1.13

2 files

2.1.12

2 files

2.1.11

2 files

2.1.10

2 files

2.1.9

2 files

2.1.8

2 files

2.1.7

2 files

2.1.6

2 files

2.1.5

2 files

2.1.4

2 files

2.1.3

2 files

2.1.2

2 files

2.1.1

2 files

Pre-release

2.1.0b5

2 files

Pre-release

2.1.0b4

2 files

Pre-release

2.1.0b3

2 files

Pre-release

2.1.0b2

2 files

0.0.1

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page