Skip to content

Repository files navigation

AIKA

The Human Communication Layer of the Voltex Network

License: MIT Python Status Part of

The face that humans talk to.

Architecture · Connectors · Quick Start · Stack


What is AIKA?

AIKA is the conversational AI product of the Voltex Network — the face that humans talk to. It handles natural language interaction across WhatsApp, Telegram, and voice interfaces, then routes intent to Ayooni for reasoning and execution.

System Position

Human ──────────────────────────────────── Execution
  |                                             |
  v                                             v
AIKA          →          Ayooni          →   Automation
(conversation)         (cognition)          (execution)
  |
  ├── WhatsApp connector
  ├── Telegram connector
  └── Voice connector

Architecture

aika/
├── agents/
│   ├── aika_core/        Core AIKA agent logic
│   ├── aika_pa/          Personal assistant agent
│   └── profiles/         Agent personality profiles
├── connectors/
│   ├── telegram/         Telegram bot connector
│   ├── whatsapp/         WhatsApp connector
│   └── voice/            Voice interface connector
├── conversation/
│   ├── context/          Session context management
│   └── memory/           Persistent user memory
├── integrations/
│   ├── ayooni/           Bridge to Ayooni cognitive layer
│   └── automation/       Direct automation hooks
├── api/                  HTTP API layer
├── config/               Connector and voice configuration
└── state/                Runtime state snapshots

Connectors

Channel Status Notes
Telegram ✅ Active Bot API via python-telegram-bot
WhatsApp 🔨 Building Via Meta Cloud API
Voice 🔨 Building Whisper STT + TTS synthesis

Stack

  • Runtime: Python 3.11+
  • Connectors: python-telegram-bot · Meta WhatsApp API
  • Voice: Whisper (STT) · Coqui TTS
  • AI: OpenAI API · Ayooni cognitive bridge

Quick Start

git clone https://github.com/Davidcarmelalex/aika
cd aika
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
python -m api.server

Configuration

# Telegram
TELEGRAM_BOT_TOKEN=your-bot-token

# WhatsApp
WHATSAPP_TOKEN=your-meta-token
WHATSAPP_PHONE_ID=your-phone-id

# Ayooni integration
AYOONI_URL=http://localhost:8000

# Voice
WHISPER_MODEL=base

Ecosystem

AIKA is part of the Voltex Network — operated by FCRI.


AIKA — The conversation layer.

About

AIKA conversation AI product

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages