G4F CLI Client

A command-line interface for interacting with various AI providers and models, supporting text and image generation with conversation history.

Installation

pip install g4f[all]

Call it in your terminal:

g4f client "Explain generative AI"

Or with:

python -m g4f.cli.client "Explain quantum computing"

Usage

usage: g4f [-h] [--debug] [-p PROVIDER] [-m MODEL] [-O [FILE]] [-i INSTRUCTIONS] [-c COOKIES_DIR]
           [--conversation-file CONVERSATION_FILE] [-C]
           [input ...]

Basic Examples

Text generation:

g4f "Explain quantum computing in simple terms"

Image description:
```
g4f image.jpg "Describe this image"
```

Image generation (with supported models):

g4f -m flux -O output.jpg "A futuristic cityscape"

Continue conversation:
```
g4f "Now explain it like I'm five"
```

Options

Option	Description
`-h`, `--help`	Show help message
`--debug`, `-d`	Enable verbose logging
`-p PROVIDER`, `--provider PROVIDER`	Specify provider (e.g., `OpenaiChat`, `Gemini`, `Grok`)
`-m MODEL`, `--model MODEL`	Specify model (provider-specific)
`-O [FILE]`, `--output [FILE]`	Save response to file (for text or image generation)
`-i INSTRUCTIONS`, `--instructions INSTRUCTIONS`	Add custom system instructions
`-c COOKIES_DIR`, `--cookies-dir COOKIES_DIR`	Directory for authenticated providers
`--conversation-file FILE`	Custom conversation state file
`-C`, `--clear-history`	Clear conversation history before starting

Features

Multi-modal support: Process both text and images
Conversation history: Maintains context between queries
Multiple providers: Supports 50+ AI providers
Image generation: With supported models (e.g., flux)
Persistent settings: Saves selected model in conversation file

Advanced Usage

Custom provider with instructions:

g4f -p PollinationsAI -i "You are a helpful science tutor" "Explain photosynthesis"

Debug mode:
```
g4f --debug "What's the weather today?"
```
Clear history and start fresh:
```
g4f -C "New conversation"
```

Save response to file:

g4f -O response.txt "Write a poem about the ocean"

Configuration

Default conversation file: ~/.config/g4f-cli/conversation.json
Default cookies directory: ~/.config/g4f-cli/cookies/

Supported Providers

The CLI supports numerous providers including:

Anthropic, BingCreateImages, Blackbox, Copilot, DeepSeek, Gemini, Grok, HuggingChat, MetaAI, OpenaiChat, PerplexityLabs, and many more.

Run g4f --help to see the complete list.

Notes

For image generation, ensure you select a model that supports it (e.g., flux)
Some providers may require authentication via cookies
The selected model is automatically saved in the conversation file