AGiXT项目环境变量配置完全指南

AGiXT项目环境变量配置完全指南

AGiXT AGiXT is a dynamic AI Agent Automation Platform that seamlessly orchestrates instruction management and complex task execution across diverse AI providers. Combining adaptive memory, smart features, and a versatile plugin system, AGiXT delivers efficient and comprehensive AI solutions. 项目地址: https://gitcode.com/gh_mirrors/ag/AGiXT

环境变量概述

在AGiXT项目中，环境变量扮演着至关重要的角色，它们决定了系统的运行方式、功能特性以及性能表现。本文将全面解析AGiXT中的各类环境变量配置，帮助开发者根据实际需求进行个性化设置。

核心环境变量详解

基础配置变量

AGIXT_API_KEY是项目的核心密钥，用于API认证。若未手动设置，系统会自动生成一个密钥，确保开箱即用的便捷性。

AGIXT_URI定义了API服务的访问地址，开发者可根据部署环境灵活配置。

版本控制方面，AGIXT_BRANCH支持选择stable(稳定版)或dev(开发版)分支，而AGIXT_AUTO_UPDATE则控制是否启用自动更新功能。

用户界面相关

界面主题可通过THEME_NAME定制，提供多种预设风格：

• 默认(default)
• 节日主题(christmas, easter, valentines)
• 特殊风格(alternative, doom, halloween)

AGIXT_SHOW_SELECTION控制界面下拉菜单的显示，默认显示代理(agent)和会话(conversation)选项，开发者可按需扩展。

数据库配置

DATABASE_TYPE支持两种数据库类型：

• sqlite：轻量级嵌入式数据库
• postgres：功能强大的关系型数据库

性能调优方面，UVICORN_WORKERS设置工作进程数量，默认值为10，可根据服务器配置调整。

ezLocalai专用配置

ezLocalai是AGiXT的重要组件，以下变量专门用于其配置：

基础设置

EZLOCALAI_URI定义服务地址，默认使用本地IP的8091端口。

模型选择

DEFAULT_MODEL指定默认语言模型，预置为QuantFactory/dolphin-2.9.2-qwen2-7b-GGUF，该模型在32k最大token数下约需9GB显存。

视觉模型通过VISION_MODEL配置，默认为deepseek-ai/deepseek-vl-1.3b-chat，需额外约3GB显存。

语音识别模型WHISPER_MODEL默认为base.en，专为英语优化。

性能调优

LLM_MAX_TOKENS控制语言模型的最大token数，默认32768。显存不足时可适当降低此值。

GPU_LAYERS设置GPU加速层数，-1表示使用全部可用层。

高级功能配置

AGIXT_RLHF启用基于人类反馈的强化学习功能，支持在UI中使用点赞/点踩按钮收集反馈。

AUTH_PROVIDER提供两种认证方式：

• none：无认证
• magicalauth：使用magicalauth认证系统

INTERACTIVE_MODE目前应保持为chat模式，form模式尚处于实验阶段。

配置建议

1. 对于显存有限的设备，建议降低LLM_MAX_TOKENS值或选择更轻量的模型
2. 生产环境推荐使用postgres数据库和稳定版分支
3. 多核服务器可适当增加UVICORN_WORKERS数量提升并发能力
4. 无GPU环境仍可运行，但需注意性能下降

完整的环境变量列表及默认值可参考项目中的get_default_env_vars()函数实现。合理配置这些变量能够显著提升AGiXT的性能和用户体验。

AGiXT AGiXT is a dynamic AI Agent Automation Platform that seamlessly orchestrates instruction management and complex task execution across diverse AI providers. Combining adaptive memory, smart features, and a versatile plugin system, AGiXT delivers efficient and comprehensive AI solutions. 项目地址: https://gitcode.com/gh_mirrors/ag/AGiXT