FileCannon

Introduction

FileCannon is an AI-powered file generation CLI tool that creates new files based on examples and natural language descriptions. It leverages AI models to generate content, making it easy to quickly create files with a structure similar to provided examples.

Installation

pip install filecannon

Then, you can use the filecannon command with the following syntax:

filecannon <prompt> [options]

Arguments:

• prompt: Description of the file to generate (required)

Options:

• -e, --example: Path to example file(s) (can be used multiple times)
• -m, --model: Model to use (default: claude-3-5-sonnet-20240620)
• -o, --output: Output directory (default: current directory)

Example:

filecannon "Create a Python script that calculates fibonacci numbers" -e examples/math_functions.py -o output/

Files

The main custom files in this project are:

• filecannon.py: The main script containing the CLI logic and core functionality
• ai_manager.py: Handles AI interactions and prompt management
• file_manager.py: Manages file operations and tool implementations
• tool_parser.py: Allows XML use of tools by FileCannon

Methods

AIManager

• generate_content(prompt: str, examples: List[str], example_contents: List[str]) -> str
• construct_prompt(user_prompt: str, context: dict) -> str

FileManager

• list_files(directory: str) -> List[str]
• read_file(path: str) -> str
• write_file(path: str, content: str) -> bool
• validate_path(path: str) -> bool

ToolParser

This component allows XML use of tools by FileCannon. The specific methods are not detailed in the specification.

Models

FileCannon supports the following AI models:

• Claude 3.5 Sonnet (default)
• OpenAI models (configurable)

Available CSS styles

This project is a CLI tool and does not include any CSS styles.

Available JS functions

This project is a CLI tool and does not include any JavaScript functions.

Additional notes

1. Environment Variables:

   • Set ANTHROPIC_API_KEY if using Claude models
   • Set OPENAI_API_KEY if using OpenAI models
   • Set OPENAI_ENDPOINT if using OpenAI (defaults to "https://api.openai.com/v1/chat/completions")

2. Dependencies:

   • openai
   • anthropic

3. The tool uses a specific conversation flow for generating content, which includes system prompts, user prompts, and assistant responses.

4. The write_file tool is used to output the generated content in XML format:

   <use_tool>
       <name>write_file</name>
       <path>path/to/output/filename.ext</path>
       <content>
           [generated content]
       </content>
   </use_tool>

5. Always ensure you have the necessary API keys and permissions set up before using the tool.

6. The generated content aims to be practical and production-ready, following the structure and conventions shown in the example files.

Part of the 255labs.xyz toolkit for AI-first development.