Cấu hình

Galaxy CLI sử dụng file config.json để quản lý cấu hình. File này cho phép bạn tùy chỉnh hành vi của Galaxy theo nhu cầu.

Vị trí file cấu hình

Galaxy CLI tìm file config.json theo thứ tự:

1. Project-level: ./config.json (trong thư mục hiện tại)
2. User-level: Global config

macOS/Linux

~/.galaxy/config.json

Windows

%USERPROFILE%\.galaxy\config.json

Hoặc: C:\Users\YourUsername\.galaxy\config.json

Ghi chú

Project-level config sẽ override user-level config.

Tạo file cấu hình

Project-level (Khuyến nghị)

macOS/Linux

# Tạo config trong project hiện tại
touch config.json

Windows (PowerShell)

# Tạo config trong project hiện tại
New-Item -Path . -Name "config.json" -ItemType "file"

Windows (CMD)

REM Tạo config trong project hiện tại
type nul > config.json

User-level (Global)

macOS/Linux

# Tạo thư mục và config file
mkdir -p ~/.galaxy
touch ~/.galaxy/config.json

Windows (PowerShell)

# Tạo thư mục và config file
New-Item -Path "$env:USERPROFILE\.galaxy" -ItemType Directory -Force
New-Item -Path "$env:USERPROFILE\.galaxy\config.json" -ItemType "file"

Windows (CMD)

REM Tạo thư mục và config file
mkdir %USERPROFILE%\.galaxy
type nul > %USERPROFILE%\.galaxy\config.json

Cấu trúc file config.json

Minimal Configuration

{
  "agent": "auto",
  "test": false,
  "review": false
}

Full Configuration

{
  "agent": "auto",
  "test": false,
  "review": false,
  "git": false,
  "apiKeys": {
    "gemini": "your_gemini_api_key",
    "claude": "your_claude_api_key",
    "openai": "your_openai_api_key"
  },
  "modelConfig": {
    "temperature": 0.7,
    "maxTokens": 8192,
    "topP": 0.95
  },
  "tools": {
    "fileOperations": true,
    "gitOperations": false,
    "commandRunner": true,
    "documentParser": true
  }
}

Các tùy chọn cấu hình

Agent Configuration

Chọn AI agent cho Galaxy:

{
  "agent": "auto"  // "auto" | "gemini" | "claude" | "gpt4" | "ollama"
}

Options:

• "auto" (default) - Galaxy tự động chọn agent phù hợp
• "gemini" - Sử dụng Google Gemini
• "claude" - Sử dụng Anthropic Claude
• "gpt4" - Sử dụng OpenAI GPT-4
• "ollama" - Sử dụng local Ollama models

Mẹo

Khuyến nghị dùng "auto" để Galaxy tự động optimize cost và performance.

Feature Flags

Enable/disable các tính năng:

{
  "test": false,    // Auto-generate tests
  "review": false,  // Code review before completion
  "git": false      // Git operations (commit, push)
}

API Keys

Cấu hình API keys cho các AI providers:

{
  "apiKeys": {
    "gemini": "AIza...",
    "claude": "sk-ant-...",
    "openai": "sk-..."
  }
}

Chú ý

Bảo mật: Không commit file config chứa API keys lên Git. Thêm config.json vào .gitignore.

Model Parameters

Tùy chỉnh behavior của AI models:

{
  "modelConfig": {
    "temperature": 0.7,    // Creativity (0-1)
    "maxTokens": 8192,     // Max response length
    "topP": 0.95           // Nucleus sampling
  }
}

Temperature Guide:

• 0.0 - 0.3: Conservative, deterministic
• 0.4 - 0.7: Balanced (recommended)
• 0.8 - 1.0: Creative, exploratory

Tools Configuration

Enable/disable specific tools:

{
  "tools": {
    "fileOperations": true,    // file_read, file_write, etc.
    "gitOperations": false,    // git_commit, git_push, etc.
    "commandRunner": true,     // Run shell commands
    "documentParser": true,    // Parse PDF, DOCX, XLSX
    "testRunner": false        // Run tests
  }
}

Ví dụ cấu hình theo use case

Development (Local)

{
  "agent": "ollama",
  "test": true,
  "review": true,
  "git": false,
  "modelConfig": {
    "temperature": 0.5
  }
}

Production (Cloud)

{
  "agent": "auto",
  "test": true,
  "review": true,
  "git": true,
  "apiKeys": {
    "gemini": "$GEMINI_API_KEY",
    "claude": "$CLAUDE_API_KEY"
  },
  "modelConfig": {
    "temperature": 0.3
  }
}

Quick Prototyping

{
  "agent": "gemini",
  "test": false,
  "review": false,
  "git": false,
  "modelConfig": {
    "temperature": 0.8
  }
}

Team Project

{
  "agent": "claude",
  "test": true,
  "review": true,
  "git": true,
  "tools": {
    "fileOperations": true,
    "gitOperations": true,
    "commandRunner": false  // Disable for security
  }
}

Environment Variables

Bạn có thể sử dụng environment variables trong config:

{
  "apiKeys": {
    "gemini": "$GEMINI_API_KEY",
    "claude": "$CLAUDE_API_KEY"
  }
}

Set Environment Variables

macOS/Linux (bash/zsh)

# Temporary (session only)
export GEMINI_API_KEY="your_key_here"
export CLAUDE_API_KEY="your_key_here"

# Permanent (add to ~/.bashrc or ~/.zshrc)
echo 'export GEMINI_API_KEY="your_key_here"' >> ~/.bashrc
source ~/.bashrc

Windows (PowerShell)

# Temporary (session only)
$env:GEMINI_API_KEY="your_key_here"
$env:CLAUDE_API_KEY="your_key_here"

# Permanent (user level)
[System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', 'your_key_here', 'User')
[System.Environment]::SetEnvironmentVariable('CLAUDE_API_KEY', 'your_key_here', 'User')

Windows (CMD)

REM Temporary (session only)
set GEMINI_API_KEY=your_key_here
set CLAUDE_API_KEY=your_key_here

REM Permanent (user level)
setx GEMINI_API_KEY "your_key_here"
setx CLAUDE_API_KEY "your_key_here"

Ghi chú

Environment variables sẽ override values trong config.json.

Xác thực cấu hình

Galaxy CLI tự động validate config khi khởi động:

galaxy

✓ Configuration loaded: ./config.json
✓ Agent: auto (using Gemini)
✓ API Keys: Gemini ✓, Claude ✗
✓ Test planning: OFF
✓ Code review: OFF

Nếu có lỗi:

✗ Invalid configuration
  - apiKeys.gemini: Invalid format
  - modelConfig.temperature: Must be between 0 and 1

Template configs

Generate default config

# Tạo config mẫu
galaxy init

# Tạo với template
galaxy init --template=production
galaxy init --template=development

Templates có sẵn

default

{
  "agent": "auto",
  "test": false,
  "review": false
}

production

{
  "agent": "claude",
  "test": true,
  "review": true,
  "git": true,
  "modelConfig": {
    "temperature": 0.3
  }
}

development

{
  "agent": "ollama",
  "test": true,
  "review": true,
  "git": false,
  "modelConfig": {
    "temperature": 0.7
  }
}

Best Practices

Use project-level config

Mỗi project nên có config.json riêng để đảm bảo consistency giữa các team members.

Never commit API keys

Luôn thêm config.json vào .gitignore nếu nó chứa API keys. Sử dụng environment variables thay thế.

.gitignore

config.json
.galaxy/

Start simple

Bắt đầu với minimal config, sau đó thêm options khi cần:

{
  "agent": "auto"
}

Chỉnh sửa config file

Sử dụng Text Editor

Visual Studio Code

# macOS/Linux
code config.json

# Windows
code config.json

Notepad (Windows)

notepad config.json

nano (macOS/Linux)

nano config.json

vim (macOS/Linux)

vim config.json

Validate JSON Syntax

Sau khi chỉnh sửa, validate JSON syntax:

Online

Copy nội dung và paste vào: https://jsonlint.com

Command Line

# Using Node.js
node -e "JSON.parse(require('fs').readFileSync('config.json', 'utf8'))"

# Using Python
python -m json.tool config.json

VS Code

VS Code tự động validate JSON và hiển thị errors

Troubleshooting

Config không được load

# Check config location
galaxy --config

# Validate config
galaxy --validate-config

API key không hoạt động

# Test API keys
galaxy --test-api-keys

# Output:
# Gemini: ✓ Valid
# Claude: ✗ Invalid or expired
# OpenAI: - Not configured

Override config temporarily

# Override cho 1 lần chạy
galaxy --agent=claude --test --review

Đường dẫn file trên Windows

Chú ý

Trên Windows, sử dụng backslash \ hoặc forward slash / trong đường dẫn:

{
  "projectPath": "C:\\Users\\Username\\Projects"
}

Hoặc:

{
  "projectPath": "C:/Users/Username/Projects"
}

Các bước tiếp theo

• Command Options - Command-line options
• Commands - Internal commands
• AI Models - Tìm hiểu về AI agents