tonym/NastyNAS
1
0
Fork 0
Code Issues 70 Pull Requests Actions Packages Projects Releases Wiki Activity

Configure big-AGI Chat Client #34

New Issue
Open
opened 2025-09-14 08:10:18 +00:00 by tonym · 0 comments
tonym commented 2025-09-14 08:10:18 +00:00
Owner
Copy Link

big-AGI Chat Client Configuration for Unraid 7.0.1

Container Installation

  • From Community Applications: Search "big-AGI"
  • Container Selection: enricoros/big-agi
  • Repository: ghcr.io/enricoros/big-agi:latest

Container Configuration

Basic Settings:

  • Container Port: 3000
  • Host Port: 3000
  • Network Mode: bridge
  • Repository Path: ghcr.io/enricoros/big-agi:latest

Volume Mappings:

  • Config: /mnt/user/appdata/big-agi:/app/data

Environment Variables:

  • PUID: 99
  • PGID: 100
  • TZ: America/Chicago
  • UMASK: 002
  • NODE_ENV: production
  • NEXT_PUBLIC_GA_MEASUREMENT_ID: (optional)

Initial Configuration

  1. First Access: http://[SERVER_IP]:3000
  2. API Setup:
    • Configure LocalAI endpoint
    • Set API keys if required
    • Test connection
  3. UI Customization: Configure interface preferences

Service Configuration

AI Provider Setup:

  • LocalAI Integration: http://[SERVER_IP]:8080/v1
  • OpenAI API: Configure if using external API
  • Model Selection: Choose available models
  • Temperature Settings: Adjust response creativity

Chat Configuration:

  • System Prompts: Configure default prompts
  • Conversation History: Set retention policies
  • Export Options: Configure data export
  • Sharing: Enable/disable conversation sharing

Integration Points

LocalAI Connection:

File Handling:

  • Document Upload: PDF, text file support
  • Image Analysis: If vision models available
  • Code Execution: If code interpreter enabled

Monitoring & Notifications

Uptime Kuma Integration:

Backup Configuration

Kopia Integration:

  • Backup Paths:
    • /mnt/user/appdata/big-agi (configuration and data)
  • Schedule: Daily at 2:30 AM
  • Retention: 30 daily, 12 monthly

Testing Procedures

Health Checks:

  1. Container Status: docker ps | grep big-agi
  2. Web Interface: Access via browser
  3. API Connection: Test LocalAI integration

Functionality Tests:

  1. Chat Interface: Test basic conversation
  2. Model Switching: Test different AI models
  3. File Upload: Test document processing
  4. Export Function: Test conversation export

Troubleshooting

Common Issues:

  1. API Connection Failed:

    • Verify LocalAI is running
    • Check API endpoint URL
    • Validate network connectivity

  2. Interface Loading Issues:

    • Clear browser cache
    • Check container logs
    • Verify port accessibility

Permission Fixes:

sudo chown -R 99:100 /mnt/user/appdata/big-agi
sudo chmod -R 755 /mnt/user/appdata/big-agi

Log Locations:

  • Container Logs: docker logs big-agi
  • Application Logs: /mnt/user/appdata/big-agi/logs

Maintenance

Regular Tasks:

  1. Clear Chat History: Monthly cleanup
  2. Update Container: Regular security updates
  3. Monitor Storage: Check disk usage
  4. Performance Review: Optimize settings
# big-AGI Chat Client Configuration for Unraid 7.0.1 ## Container Installation - **From Community Applications:** Search "big-AGI" - **Container Selection:** enricoros/big-agi - **Repository:** ghcr.io/enricoros/big-agi:latest ## Container Configuration **Basic Settings:** - **Container Port:** 3000 - **Host Port:** 3000 - **Network Mode:** bridge - **Repository Path:** ghcr.io/enricoros/big-agi:latest **Volume Mappings:** - **Config:** /mnt/user/appdata/big-agi:/app/data **Environment Variables:** - **PUID:** 99 - **PGID:** 100 - **TZ:** America/Chicago - **UMASK:** 002 - **NODE_ENV:** production - **NEXT_PUBLIC_GA_MEASUREMENT_ID:** (optional) ## Initial Configuration 1. **First Access:** http://[SERVER_IP]:3000 2. **API Setup:** - Configure LocalAI endpoint - Set API keys if required - Test connection 3. **UI Customization:** Configure interface preferences ## Service Configuration **AI Provider Setup:** - **LocalAI Integration:** http://[SERVER_IP]:8080/v1 - **OpenAI API:** Configure if using external API - **Model Selection:** Choose available models - **Temperature Settings:** Adjust response creativity **Chat Configuration:** - **System Prompts:** Configure default prompts - **Conversation History:** Set retention policies - **Export Options:** Configure data export - **Sharing:** Enable/disable conversation sharing ## Integration Points **LocalAI Connection:** - **Endpoint:** http://[SERVER_IP]:8080 - **Model List:** Auto-discovery from LocalAI - **API Compatibility:** OpenAI-compatible **File Handling:** - **Document Upload:** PDF, text file support - **Image Analysis:** If vision models available - **Code Execution:** If code interpreter enabled ## Monitoring & Notifications **Uptime Kuma Integration:** - **Monitor Type:** HTTP - **URL:** http://[SERVER_IP]:3000 - **Check Interval:** 60 seconds - **Alert Threshold:** 3 failures ## Backup Configuration **Kopia Integration:** - **Backup Paths:** - /mnt/user/appdata/big-agi (configuration and data) - **Schedule:** Daily at 2:30 AM - **Retention:** 30 daily, 12 monthly ## Testing Procedures **Health Checks:** 1. **Container Status:** docker ps | grep big-agi 2. **Web Interface:** Access via browser 3. **API Connection:** Test LocalAI integration **Functionality Tests:** 1. **Chat Interface:** Test basic conversation 2. **Model Switching:** Test different AI models 3. **File Upload:** Test document processing 4. **Export Function:** Test conversation export ## Troubleshooting **Common Issues:** 1. **API Connection Failed:** - Verify LocalAI is running - Check API endpoint URL - Validate network connectivity 2. **Interface Loading Issues:** - Clear browser cache - Check container logs - Verify port accessibility **Permission Fixes:** ```bash sudo chown -R 99:100 /mnt/user/appdata/big-agi sudo chmod -R 755 /mnt/user/appdata/big-agi ``` **Log Locations:** - **Container Logs:** docker logs big-agi - **Application Logs:** /mnt/user/appdata/big-agi/logs ## Maintenance **Regular Tasks:** 1. **Clear Chat History:** Monthly cleanup 2. **Update Container:** Regular security updates 3. **Monitor Storage:** Check disk usage 4. **Performance Review:** Optimize settings
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
tonym
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: tonym/NastyNAS#34
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?