Skip to content
View OpenAnimal's full-sized avatar

Block or report OpenAnimal

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
OpenAnimal/README.md

OA raptor flat

OpenAnimal – OpenBrain 🦖

🧠 Neural Networks | 📚 LLM/VLM | 🤖 Robot Hardware | 📱 Android

📘 Official Documentation

Overview

OpenAnimal is an extensible Unreal Engine–based framework for modeling and simulating animal- and human-like behavior. It integrates neural networks, behavior modeling, speech processing, and optional robotics interfaces directly within Unreal Engine, with an emphasis on transparency and autonomous operation.

OpenBrain is a self-contained, plug-and-play Animal Brain system designed to bring autonomous behavior to any Actor in Unreal Engine and to physical platforms. This module focuses on extensibility, aiming to simulate natural animal cognition and social interaction (rather than high-level intelligence).

The system is built to run fully offline with a design optimized for affordable, widely available platforms, including mobile devices. Future updates will expand behavioral depth and capabilities.

Key Features

  • Native Unreal Engine ONNX neural-network inference in Blueprints
  • Asynchronous processing pipelines
  • Speech-to-Text and speaker recognition
  • Animal pose, face, and gaze detection
    Estimate posture, orientation, and visual focus.
  • Behavior and emotional-state modeling (preliminary)
    Early-stage behavior generation and emotion approximation.
  • Platform-independent ONNX networks
    Single-file ONNX models that are openly available and operate consistently across platforms.
  • Bottom-up autonomous intelligence modeling
    Designed to build emergent behavior from atomic perceptual and processing components.
  • Android and Arduino based
    Enabling integration with broad variety of hardware setups

Use Cases

  • Construction of autonomous pet-like agents
  • Educational scenarios and demonstrations
  • Robotics and hardware prototyping
  • Research simulations, Social behavior studies and modeling

Dependencies

  • ONNX Neural Networks
    See: Neural Networks README for all single-file ONNX networks For convenience a Utility Widget is provided to automatically download the networks to the correct location.

Optional

  • VaRest (optional, but highly recommended)
    Reliable HTTP/URL communication layer for interacting with hardware and large/visual language models.
    (Unreal Engine’s built-in HTML communication methods are yet too unstable; VaRest is the battle-tested solution currently used.)

  • Ollama
    For local execution of large and visual language models, including support for cloud-based model computation via the new Ollama cloud-model options.

Platforms

  • Windows 64-bit
  • Android

Release State and Disclaimer

This is an early-stage release and was published under high time pressure. Some features are incomplete, and bugs may exist. Development will continue, and the project is expected to expand over time.

Contact & Support

Email: OpenAnimal@outlook not .com but .de For questions that may benefit others, please open an Issue here on GitHub

Popular repositories Loading

  1. OpenAnimal OpenAnimal Public

    Official Repository of the OpenAnimal OpenBrain Unreal Engine Plugin

    C++