Advanced AI assistant with 3D avatar, lip-sync, Microsoft Phi-4 Multimodal integration, biometric security, voice, vision, and robotics capabilities
Tektra AI Assistant is an advanced AI assistant featuring 3D Avatar with Lip-Sync, Biometric Security, Microsoft Phi-4 Multimodal integration with superior voice, vision, and robotics capabilities. It delivers state-of-the-art speech recognition, intelligent chat completion, multimodal understanding, and immersive avatar interactions with persistent conversation management and a beautiful web interface.
Install Tektra with UV (recommended):
# Install UV if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh
# Basic installation
uv tool install tektra
# With all optional features
uv tool install tektra --with tektra[all]
# Alternative: Traditional pip installation also works
pip install tektra
Just run Tektra - setup happens automatically!
tektra
That's it! 🎉
http://localhost:8000tektra start # Explicit start command
tektra enhance # Enhanced setup with guided Phi-4 configuration
tektra enable-phi4 # Manually enable Phi-4 if needed
uv tool install tektra → tektra → Done!tektra setup - directories, database, and models initialize automaticallytektra and everything works immediatelyuv sync --all-extras for seamless dev setup/api/v1/audio/phi4/load - Load Phi-4 Multimodal model/api/v1/audio/phi4/unload - Unload model to free memory/api/v1/audio/phi4/info - Get model status and capabilities# Start the server (default command)
tektra
# Start with custom options
tektra start --host 0.0.0.0 --port 8000 --no-browser
# Enhanced setup (server + Phi-4 guidance)
tektra enhance
# Enable Phi-4 Multimodal (superior AI)
tektra enable-phi4
# Check Phi-4 status
tektra phi4-status
# Disable Phi-4 (free memory)
tektra disable-phi4
# Show system information
tektra info
# Show version
tektra version
# Get help
tektra --help
Once started, you can:
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
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
pip install tektra
pip install tektra[ml]
pip install tektra[audio]
pip install tektra[vision]
pip install tektra[robotics]
pip install tektra[all]
git clone https://github.com/dirvine/tektra.git
cd tektra
uv sync --all-extras
# Clone the repository
git clone https://github.com/dirvine/tektra.git
cd tektra
# Install in development mode with UV
uv sync --all-extras
# Set up pre-commit hooks
uv run pre-commit install
# Run tests
uv run pytest
# Start development server
uv run tektra start --reload --debug
Installation Problems:
# If you get permission errors
pip install --user tektra
# If you have dependency conflicts
pip install tektra --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
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by Saorsa Labs
FAQs
Advanced AI assistant with 3D avatar, lip-sync, Microsoft Phi-4 Multimodal integration, biometric security, voice, vision, and robotics capabilities
We found that tektra demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Threat actors hijacked Toptal’s GitHub org, publishing npm packages with malicious payloads that steal tokens and attempt to wipe victim systems.
Research
/Security News
Socket researchers investigate 4 malicious npm and PyPI packages with 56,000+ downloads that install surveillance malware.
Security News
The ongoing npm phishing campaign escalates as attackers hijack the popular 'is' package, embedding malware in multiple versions.