FaMou-Agent-CLI

FaMou-Agent-CLI (famou-agent-cli) is a customized AI agent CLI based on Gemini CLI, adapted for the FaMou Evolutionary Framework with enhanced agent capabilities for problem clarification, automated evaluator generation, and evolutionary solver integration for the FaMou framework.

Key Features

Specialized Agents

FaMou-CLI includes specialized agents for the FaMou Evolutionary Framework:

• Problem Clarification Agent

  • Interactive agents that help users clarify and refine problem definitions
  • Configurable confidence threshold for auto-proceed (default: 0.8)
  • Maximum clarification rounds with keyword-based FaMou request detection

• FaMou Task Artifacts Implement Agent

  • Automatically generates init.py (initial solution), evaluator.py (deterministic evaluator), and prompt.md from problem.md
  • Validates generated code against problem specifications
  • Ensures I/O format, constraints, and scoring rules are correctly implemented

Experiment Management

• Experiment Submission

  • Submit evolutionary experiment tasks with customizable evolution parameters
  • Configure experiment settings through config.yaml
  • Automatic validation of required artifacts (initial program, evaluator, prompt)
  • Seamless integration with FaMou Evolutionary Framework backend

• Experiment Tracking & Display

  • View all experiments and their running status with /list command
  • Retrieve current best programs and experiment reports
  • Monitor experiment progress in real-time
  • Manage experiments (update, delete) based on their status

Installation

Prerequisites

• Node.js 20 or higher
• npm or yarn
• macOS, Linux, or Windows (WSL2 recommended)

Quick Install

Install via npm (Published as famou-agent-cli)

npm install -g famou-agent-cli

Configuration

FaMou CLI stores configuration in ~/.famou/settings.json:

Usage

Interactive Mode

Start in the current directory:

famou

The CLI will provide an interactive terminal interface with full agent capabilities.

Non-Interactive Mode

Get a simple text response (great for scripts):

famou -p "Explain the architecture of this codebase"

Command Usage

FaMou Agent CLI provides intelligent assistance for creating and managing evolutionary tasks. Here's the common workflow:

Command List

1. /login - Authenticate with your account credentials
2. /init - Initialize a new experiment folder (generates config.yaml)
3. /focus - Set the Agent's experiment directory for clean context
4. /experiment - Submit an experiment task
5. /list - View all experiments and their status
6. /settings - Configure CLI settings (log level, log file path)
7. /logs [lines] - View log output (default 50 lines)
8. /theme - Customize the CLI theme style

Command Details

/login Authenticate using your account credentials. This is required before submitting experiments or viewing the experiment list.

/init Initialize a new experiment folder. This command generates a config.yaml file with default configurations. You can modify the evolution parameters (evolve_config) and file path configurations before submitting.

/focus Set the Agent's working directory to establish a clear, clean context environment.

Note:

• The Agent can only access files within the current focus folder
• Switching focus directory will reset the current Agent context

/experiment Submit an experiment task. The experiment folder must contain:

• Initial program (default: init.py)
• Evaluator (default: evaluator.py)
• Prompt file (default: prompt.md)

File paths must match the configuration in config.yaml.

/list View all experiments and their running status. You can:

• Get the current best program
• Get experiment reports
• Update or delete experiments (depending on status)

/settings Configure CLI settings including log level and log file path for troubleshooting and debugging.

/logs [lines] View log output. Default shows recent 50 lines. Specify number of lines (e.g., /logs 100) to view more.

/theme Customize the CLI theme style.

For more features and the complete experience, visit: https://famou.com