script-magic 0.1.0

Add your description here

Script Magic 🪄

Script Magic is a CLI tool for creating, managing, and running Python scripts with GitHub Gists integration and AI-powered script generation.

Features

• 🤖 AI-Powered Script Generation: Create Python scripts from natural language prompts using OpenAI's GPT models
• ☁️ GitHub Gist Integration: Store and manage scripts in GitHub Gists for easy sharing and versioning
• 🔄 Simple Script Management: Run, update, and manage your scripts with easy commands
• 📦 Automatic Dependency Management: Script execution with uv handles dependencies automatically
• 🚀 Interactive Mode: Refine generated scripts interactively before saving

Installation

Prerequisites

• Python 3.9+
• uv for Python package management and script execution
• GitHub account with a Personal Access Token
• OpenAI API key

Quick Install

# Clone the repository
git clone https://github.com/yourusername/script-magic.git
cd script-magic

# Install with uv
uv venv
uv pip install -e .

# Set up your environment variables
export OPENAI_API_KEY="your-openai-api-key"
export GITHUB_PAT="your-github-personal-access-token"

Usage

Creating Scripts

Generate a new script from a natural language prompt:

sm create hello-world "Create a script that prints 'Hello, World!' with timestamp"

Generate with interactive preview:

sm create fibonacci --preview "Generate a script to print the first 10 Fibonacci numbers"

Running Scripts

Run a script that has been previously created:

sm run hello-world

Pass parameters to the script:

sm run hello-world --name="John"

Force refresh from GitHub before running:

sm run hello-world --refresh

Listing Scripts

View all scripts in your inventory:

sm list

Show detailed information about your scripts:

sm list --verbose

Filter scripts by tag:

sm list --tag python --tag backup

Deleting Scripts

Remove a script from both local inventory and GitHub Gists:

sm delete script-name

Force deletion without confirmation:

sm delete script-name --force

Configuration

Script Magic stores configuration in the ~/.sm directory:

• ~/.sm/config.json: Main configuration file
• ~/.sm/logs/: Log files for debugging
• ~/.sm/mapping.json: Maps script names to GitHub Gist IDs

Structure

script-magic/
├── src/
│   └── script_magic/
│       ├── __init__.py             # CLI entry point with command registration
│       ├── create.py               # Script creation command
│       ├── run.py                  # Script execution command
│       ├── list.py                 # Script listing command
│       ├── delete.py               # Script deletion command
│       ├── github_integration.py   # GitHub Gist API integration
│       ├── pydantic_ai_integration.py  # AI script generation
│       ├── mapping_manager.py      # Script mapping management
│       ├── logger.py               # Logging configuration
│       └── rich_output.py          # Terminal output formatting

Environment Variables

• OPENAI_API_KEY: Your OpenAI API key
• GITHUB_PAT: GitHub Personal Access Token with Gist permissions
• SM_CONFIG_DIR: (Optional) Custom directory for Script Magic configuration

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• PydanticAI for AI integration
• Click for the CLI interface
• PyGitHub for GitHub API integration
• Rich for beautiful terminal output