Getting Started with CLLOVA

Installation Guide

Step 1: Download the installer package

wget https://downloads.cllova.ai/latest/installer.sh

Step 2: Run with administrator privileges

chmod +x installer.sh
sudo ./installer.sh

Step 3: Verify installation

cllova --version  # Should return v2.1.0 or higher

First-Time Setup

After installation, run the setup wizard:

cllova setup

You'll configure:

  • Default microphone
  • Wake word sensitivity
  • Network connections

Voice Training

Improve accuracy by training CLLOVA to recognize your voice:

cllova train-voice

Follow the on-screen prompts to read 10 sample sentences. This takes about 3 minutes.

Troubleshooting Common Issues

Microphone Not Working

Symptoms: CLLOVA doesn't respond to wake word or commands

Solutions:

  1. Check hardware connections
  2. Verify microphone permissions:
    ls -l /dev/audio*  # Should show your mic device
  3. Test with system recorder:
    arecord -d 5 test.wav && aplay test.wav

Wi-Fi Connectivity Issues

Diagnostic commands:

cllova network-status  # Check connection state
ping api.cllova.ai    # Test cloud connectivity

Reset network config:

sudo cllova-network --reset

System Crashes

If CLLOVA crashes unexpectedly:

  1. Check logs:
    journalctl -u cllova -n 50 --no-pager
  2. Submit crash report:
    cllova bug-report --upload

Developer Resources

API Documentation

Access the full API reference:

# Local docs (after installation)
cllova docs --web

Or visit: developer.cllova.ai/api

Skill Development Kit

Install the SDK:

pip install cllova-sdk

Sample skill template:

from cllova.sdk import Skill

class MySkill(Skill):
    def initialize(self):
        self.register_intent("greet", self.handle_greet)
    
    def handle_greet(self):
        return {"response": "Hello from my skill!"}

Submit a Skill

Package your skill:

cllova-skill pack ./my_skill

Submit to the marketplace:

cllova marketplace submit my_skill.zip

Review process takes 1-3 business days.