Aktiva AI

Introduction

Aktiva AI is a versatile self-hosted Discord bot designed to enable users to interact seamlessly with multiple AI personalities in a single environment. Whether you're roleplaying, gathering information, looking for backup to support your argument, or just having fun, Aktiva AI leverages the latest advancements in AI technology.

Multiple Personalities

Switch between AI characters effortlessly for diverse interactions.

Channel Memory

Each channel and thread maintains its own memory context.

Multimodal

Process both text and images with visual recognition capabilities.

"Aktiva AI transforms your Discord server into an interactive playground where AI personalities can converse, remember, and assist according to their unique characteristics."

Features

Seamless Character Swapping

Talk to multiple AI characters through one bot, with each using webhooks for unique avatars.

Trigger AI characters by saying their name
Use /get_whitelist for available characters
Hide messages from context with // prefix

Channel-Based Memory

Each channel and thread maintains its own dedicated memory for immersive interactions.

Set memory for current channel

/set_instruction [text]

Set global channel data

/set_global [text]

Image Recognition

Integrated with Microsoft's Florence-2 AI for powerful multimodal capabilities.

Upload an image with:

"What's in this image?"

Web Search Integration

Powered by DuckDuckGo for real-time information during conversations.

Prefix your query with ^ for web search

^ (latest AI developments)

PDF File Reading

Upload PDF documents for AI characters to analyze and provide insights.

Simply upload a PDF file and ask:

"Can you summarize this document for me?"

Installation

Docker Installation (Recommended)

Clone the repository
Create your .env file
Launch your LLM with Koboldcpp
Run the docker container
Whitelist the default bot

git clone --branch main https://github.com/Iteranya/AktivaAI.git
cd AktivaAI
docker compose up -d

This is the simplest method to get started quickly!

Manual Installation

Clone the repository
Create virtual environment
Create .env file
Install requirements
Launch LLM with Koboldcpp
Run the bot

git clone --branch main https://github.com/Iteranya/AktivaAI.git
cd AktivaAI
python3 -m venv venv
source venv/bin/activate
python3 -m pip install -r requirements.txt
python bot.py

Prerequisites

LLM Model

Recommended models:

Stheno 8B
Nyanade 7B

Backend

Koboldcpp

github.com/LostRuins/koboldcpp

Configuration

Environment file with:

Discord Token
OpenRouter Key

Usage Guide

Getting Started

After installation, activate the bot by whitelisting the default character:

/set_whitelist Vida-chan

Then simply mention the bot or type a message directed at "Vida-chan" to start chatting!

Basic Commands

/set_instruction [text]

Modify instructions for a character

/set_global [text]

Change global channel data

/get_whitelist

List available characters

/clear_whitelist

Remove character restrictions

Advanced Commands

/set_text_eval_model [model_name]

Change the AI evaluation model

/get_text_eval_model

View the active model

/aktiva import_character [json]

Import a new character via JSON

/aktiva pygmalion_import [uuid]

Import from Pygmalion

Character Creation

JSON Configuration

Create a JSON file in the characters/ folder following this structure:

{
  "name": "Vida-chan",
  "description": "A helpful AI assistant",
  "type": "assistant",
  "initial_message": "Hello! How can I help you today?",
  "avatar_url": "https://example.com/avatar.png",
  "prompt": "You are Vida-chan, a helpful assistant...",
  "parameters": {
    "temperature": 0.7,
    "top_p": 0.9
  }
}

SillyTavern Character Cards

You can also import existing SillyTavern character cards:

/aktiva import_character [paste_json_here]

Pygmalion Characters

Import characters directly from Pygmalion using their UUID:

/aktiva pygmalion_import [character_uuid]

Credits

Aktiva AI was made possible by:

The beta testers at Ambruk Academy Discord
The open-source community for libraries like Koboldcpp and Florence AI
Microsoft's Florence-2 Visual AI

Join our Discord community

Aktiva Institute