Install Animus Framework

Prerequisites

Before installing Animus, ensure you have the following installed on your system:

Python 3.8 or higher
pip (Python package manager)
Git (for cloning repositories)
Virtual environment tool (recommended: venv or conda)

Animus Installer BOOTSTRAP

The Animus Installer is a comprehensive bootstrap script that automates the complete installation and configuration of the Animus multi-agent system. It sets up a production-ready environment with multiple Letta agent instances, shared resources, Docker containers, SSL certificates, and reverse proxy configuration.

What It Installs

Multi-agent architecture with complete isolation
Shared Python environment and SMCP service
Docker containers for Letta instances
Nginx reverse proxy with SSL/TLS certificates
Automated startup and monitoring via cron
MCP Protocol compliance for agent communication

System Requirements

Operating System: Ubuntu, WSL, or Raspbian
Root access (sudo privileges required)
A domain name pointing to your server
Internet connection for package installation

1. Clone the installer repository

git clone https://github.com/AnimusUNO/installer.git
cd installer

2. Customize the bootstrap script

nano kernel-installer/animus_bootstrap.sh

Important: You must customize the following variables before running:

DOMAIN - Your actual domain name
EMAIL - Your email for SSL certificates
LETTAPASS - Secure password for Letta
OPENAI_API_KEY - Your OpenAI API key
ANTHROPIC_API_KEY - Your Anthropic API key

3. Run the installation

sudo bash kernel-installer/animus_bootstrap.sh

4. Verify installation

# Check if Letta container is running
docker ps | grep letta

# Check Nginx status
sudo systemctl status nginx

# Check SSL certificate
sudo certbot certificates

Security Note: Never run with default template values. Always use strong, unique passwords and keep your API keys secure. The installer sets up HTTPS by default for production security.

View on GitHub →

Thalamus CORE

The Thalamus is the core routing and message handling system for Animus. It orchestrates communication between different modules and manages the agent's cognitive architecture.

1. Clone the repository

git clone https://github.com/AnimusUNO/thalamus.git
cd thalamus

2. Create and activate virtual environment

# Using venv
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Or using conda
conda create -n animus python=3.10
conda activate animus

3. Install dependencies

pip install -r requirements.txt

Note: The Thalamus serves as the central nervous system of your agent. Install this first before adding sensory modules.

View on GitHub →

Cochlea AUDIO

The Cochlea module provides audio input capabilities, enabling your agent to process and understand spoken language and environmental sounds. Compatible with both Thalamus and Letta integration patterns.

1. Clone the repository

git clone https://github.com/AnimusUNO/cochlea.git
cd cochlea

2. Install dependencies

pip install -r requirements.txt

3. Configure audio input

# List available audio devices
python -m cochlea.devices

# Set your preferred input device in config
python -m cochlea.configure

Note: Requires a working microphone or audio input device. Test your setup with the included diagnostic tools.

View on GitHub →

Getting Started

With Thalamus and Cochlea installed, you have the core components needed to build an Animus agent with sensory input and cognitive routing. Additional modules and integrations are under active development.

Coming Soon: Additional cognitive modules (Cerebellum, Hippocampus) and integration tools are currently in development. Follow the repository for updates.

Need Help?

Join our community for support, share your agents, and collaborate with other developers.

Join our Discord community for real-time support
Report issues on GitHub for specific repositories
Check the documentation at each repository's README
Explore example agents in the examples/ directory

View All Repositories →