CoAI LogoCoAI.Dev

Quick Start Guide

Get CoAI.Dev up and running in 5 minutes

Quick Start Guide

Get your CoAI.Dev instance running in under 5 minutes with this streamlined setup guide.

Prerequisites

Before starting, ensure you have:

  • Docker and Docker Compose installed
  • At least 2GB RAM and 1GB disk space
  • An API key from at least one AI provider (OpenAI, Anthropic, etc.)

Setup Process

Download and Deploy

Clone the repository and start with Docker Compose:

git clone --depth=1 --branch=main --single-branch https://github.com/coaidev/coai.git
cd chatnio
docker-compose up -d

Your CoAI.Dev instance will be available at http://localhost:8000

Initial Login

  1. Open your browser and navigate to your CoAI.Dev instance
  2. Use the default admin credentials:
    • Username: root
    • Password: chatnio123456

Security Notice

Important: Change the default password immediately after first login for security reasons.

Configure Your First AI Channel

Navigate to the admin panel and set up your first AI provider:

  1. Access Admin Panel: Click on the admin/settings icon in the navigation
  2. Go to Channel Management: Find "Channels" in the admin sidebar
  3. Add New Channel: Click the "Add Channel" button
  4. Select Provider Type: Choose your AI provider (e.g., OpenAI, Anthropic)
  5. Configure Settings:
    {
      "name": "My OpenAI Channel",
      "type": "openai",
      "priority": 1,
      "weight": 100,
      "api_key": "your-openai-api-key",
      "base_url": "https://api.openai.com/v1"
    }
  6. Test Connection: Use the test button to verify your configuration
  7. Save Channel: Click save to activate the channel

Add Models to Workspace

Configure which AI models appear in your chat interface:

  1. Navigate to Model Market: Go to "Model Market" in the main navigation
  2. Browse Available Models: View all configured models
  3. Add to Workspace: Click "Add to Workspace" on models you want to use
  4. Customize Display: Configure model names, descriptions, and tags as needed

Popular model configurations:

  • GPT-4: For complex reasoning and analysis
  • GPT-3.5 Turbo: For fast, cost-effective conversations
  • Claude: For detailed writing and analysis
  • Gemini: For multimodal capabilities

Test Your Setup

Verify everything is working correctly:

  1. Start a Conversation: Go to the main chat interface
  2. Select a Model: Choose from your workspace models
  3. Send a Test Message: Try "Hello, can you help me test this AI service?"
  4. Monitor Logs: Check the admin panel for request logs and analytics

Success!

If you receive a response, congratulations! Your CoAI.Dev instance is fully operational.

Next Steps

Now that CoAI.Dev is running, explore these advanced features:

🔧 Configure Additional Channels

💰 Set Up Billing

👥 Manage Users

📊 Monitor Performance

Common Issues

Database Connection Error

Problem: "Cannot connect to database"

Solution: Ensure MySQL is running and accessible. Check the connection parameters in your environment variables or configuration file.

API Key Invalid

Problem: "Invalid API key" when testing channels

Solution: Verify your API key is correct and has proper permissions. Some providers require specific scopes or billing setup.

Models Not Appearing

Problem: Models don't show up in the chat interface

Solution: Make sure you've added models to your workspace in the Model Market section. Only workspace models appear in the chat interface.

Production Deployment

For production use, consider these additional configurations:


Need help? Check the troubleshooting guide or visit our GitHub repository for community support.

On this page