# G3 General Purpose AI Agent

A code-first AI agent that helps you complete tasks by writing and executing code or scripts.

## Philosophy

G3 doesn't just give you advice - **it writes and runs code to solve your problems**. Whether you need to:
- Process data files
- Automate workflows
- Scrape websites
- Manipulate files
- Analyze logs
- Generate reports
- Set up environments

G3 will write the appropriate scripts (Python, Bash, JavaScript, etc.) and can execute them for you.

## Features

- **Code-First Approach**: Always tries to solve problems with executable code
- **Multi-Language Support**: Generates Python, Bash, JavaScript, Rust, and more
- **Modular Architecture**: Clean separation between CLI, core engine, and LLM providers
- **Multiple LLM Providers**: Support for OpenAI, Anthropic, and extensible to other providers
- **Interactive Mode**: Chat with the AI and watch it solve problems in real-time
- **Task Automation**: Create reusable automation scripts

## Installation

```bash
cargo install --path .
```

## Configuration

Create a configuration file at `~/.config/g3/config.toml`:

```toml
[providers]
default_provider = "openai"

[providers.openai]
api_key = "your-openai-api-key"
model = "gpt-4"
max_tokens = 2048
temperature = 0.1

[providers.anthropic]
api_key = "your-anthropic-api-key"
model = "claude-3-sonnet-20240229"
max_tokens = 2048
temperature = 0.1

[agent]
max_context_length = 8192
enable_streaming = true
timeout_seconds = 60
```

## Usage

### Interactive Mode (Default)

Simply run G3 to start interactive mode:

```bash
g3
```

Example interactions:
```
g3> Process this CSV file and show me the top 10 customers by revenue
# G3 writes Python pandas script to analyze the CSV

g3> Set up a backup script for my home directory
# G3 creates a bash script with rsync/tar commands

g3> Download all images from this webpage
# G3 writes a Python script with requests/BeautifulSoup

g3> Convert these JSON files to a SQLite database
# G3 creates a Python script to parse JSON and insert into SQLite
```

### Direct Commands

You can also use G3 with direct commands:

```bash
# Solve any task with code
g3 task "merge these PDF files into one"
g3 task "find all TODO comments in my codebase"

# Create automation scripts
g3 automate "daily backup of my projects folder"
g3 automate "resize all images in a folder to 800px width"

# Data processing
g3 data "analyze this log file for error patterns"
g3 data "convert CSV to JSON with validation"

# Legacy code commands (still supported)
g3 analyze src/main.rs
g3 generate "fibonacci function" --output fib.py
g3 review src/lib.rs
```

## Architecture

G3 follows the Unix philosophy with modular, composable components:

- **g3-cli**: Command-line interface
- **g3-core**: Core agent logic and orchestration
- **g3-providers**: LLM provider abstractions
- **g3-config**: Configuration management

See [DESIGN.md](DESIGN.md) for detailed architecture documentation.

## Development

```bash
# Build all crates
cargo build

# Run tests
cargo test

# Run with debug logging
RUST_LOG=debug cargo run -- analyze src/
```

## License

MIT