tektra 0.1.0

Advanced AI assistant with voice, vision, and robotics capabilities

Tektra AI Assistant

Tektra AI Assistant is an advanced AI assistant with voice, vision, and robotics capabilities. It features persistent conversation management, real-time chat, streaming responses, and a beautiful web interface.

✨ Features

🧠 Advanced AI Integration

• Multiple Model Support: Phi-3, GPT, Llama, and more
• Streaming Responses: Real-time token-by-token generation
• Context Awareness: Conversation history and memory management
• Model Management: Load, unload, and switch between models

💬 Rich Chat Interface

• Persistent Conversations: Full conversation history with database storage
• Real-time Chat: WebSocket-based streaming chat
• Conversation Management: Create, search, organize, and delete conversations
• Message Actions: Copy, regenerate, and manage individual messages
• Beautiful UI: Modern, responsive web interface

🎤 Multimodal Capabilities

• Voice Input: Speech-to-text with real-time transcription
• Voice Output: Text-to-speech with natural voices
• Vision: Image analysis and computer vision
• Camera Integration: Real-time video processing

🤖 Robotics & Automation

• Robot Control: Command and control robotic systems
• Avatar System: 3D avatar with expressions and gestures
• Real-time Communication: WebSocket-based robot communication
• Safety Features: Emergency stop and safety monitoring

🚀 Quick Start

Installation

Install Tektra AI Assistant with pip:

# Basic installation
pip install tektra-ai

# With all optional features
pip install tektra-ai[all]

# With specific features
pip install tektra-ai[ml,audio,vision]

Setup and First Run

1. Initial Setup (first time only):

   tektra setup
   

2. Start the Assistant:

   tektra start
   

3. Open Your Browser: The web interface will automatically open at http://localhost:8000

That's it! 🎉

📖 Usage

Command Line Interface

# Start the server (with options)
tektra start --host 0.0.0.0 --port 8000 --browser

# Setup for first use
tektra setup

# Show system information
tektra info

# Show version
tektra version

# Get help
tektra --help

Web Interface

Once started, you can:

1. Chat with AI: Start conversations with intelligent responses
2. Manage Conversations: Browse, search, and organize your chat history
3. Voice Interaction: Use voice input and output
4. Control Systems: Manage robots, avatars, and connected devices

🔧 Configuration

Environment Variables

Create a .env file in your working directory:

# Database
DATABASE_URL=sqlite:///./tektra.db

# Server
HOST=0.0.0.0
PORT=8000
DEBUG=false

# AI Models
MODEL_CACHE_DIR=./models
MAX_MODEL_MEMORY_GB=8

# Audio
AUDIO_SAMPLE_RATE=16000
MAX_AUDIO_DURATION=30

# API Keys (optional)
OPENAI_API_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key

🏗️ Architecture

Tektra AI Assistant is built with a modern, modular architecture:

tektra/
├── app/                    # Main application
│   ├── routers/           # API endpoints
│   ├── services/          # Business logic
│   ├── models/            # Database models
│   ├── database.py        # Database management
│   └── config.py          # Configuration
├── frontend/              # Web interface (React/Next.js)
├── cli.py                 # Command-line interface
└── server.py              # Server management

Technology Stack

• Backend: FastAPI, SQLAlchemy, WebSockets, Python 3.9+
• Frontend: Next.js, React, TypeScript, Tailwind CSS
• Database: SQLite (default), PostgreSQL (optional)
• AI/ML: Transformers, PyTorch, MLX (Apple Silicon)
• Audio: PyAudio, LibROSA, SoundFile
• Vision: OpenCV, MediaPipe

📦 Installation Options

Basic Installation

pip install tektra-ai

With Machine Learning

pip install tektra-ai[ml]

With Audio Support

pip install tektra-ai[audio]

With Vision Support

pip install tektra-ai[vision]

With Robotics Support

pip install tektra-ai[robotics]

Everything Included

pip install tektra-ai[all]

Development Installation

git clone https://github.com/tektra/tektra-ai.git
cd tektra-ai
pip install -e .[dev,all]

🛠️ Development

Setting Up Development Environment

# Clone the repository
git clone https://github.com/tektra/tektra-ai.git
cd tektra-ai

# Install in development mode
pip install -e .[dev,all]

# Set up pre-commit hooks
pre-commit install

# Run tests
pytest

# Start development server
tektra start --reload --debug

🐛 Troubleshooting

Common Issues

Installation Problems:

# If you get permission errors
pip install --user tektra-ai

# If you have dependency conflicts
pip install tektra-ai --no-deps
pip install -r requirements.txt

Audio Issues:

# On macOS
brew install portaudio
pip install pyaudio

# On Ubuntu/Debian
sudo apt-get install portaudio19-dev
pip install pyaudio

Database Issues:

# Reset database
rm tektra.db
tektra setup

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with ❤️ by the Tektra Team