# agent-c

**Repository Path**: dragondjf/agent-c

## Basic Information

- **Project Name**: agent-c
- **Description**: No description available
- **Primary Language**: C
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-30
- **Last Updated**: 2025-08-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent-C

A ultra-lightweight AI agent written in C that communicates with OpenRouter API and executes shell commands.

![Agent-C Preview](preview.webp)

## Features

- **Tool Calling**: Execute shell commands directly through AI responses
- **Optimized Binaries**: 4.4KB on macOS (GZEXE), ~16KB on Linux (UPX)
- **Conversation Memory**: Sliding window memory management for efficient operation
- **Cross-Platform**: macOS and Linux

## Quick Start

### Prerequisites

- GCC compiler
- curl command-line tool
- OpenRouter API key
- macOS: gzexe (usually pre-installed)
- Linux: upx (optional, for compression)

### Build

```bash
make
```

The build system auto-detects your platform and applies optimal compression:
- **macOS**: Uses GZEXE compression → 4.4KB binary
- **Linux**: Uses UPX compression → ~16KB binary

### Setup

Set your OpenRouter API key:

```bash
export OR_KEY=your_openrouter_api_key_here
```

### Run

```bash
./agent-c
```

## License

**CC0 - "No Rights Reserved"**