{"id":17381861,"url":"https://github.com/tyfiero/script-o-matic","last_synced_at":"2025-05-15T05:31:29.170Z","repository":{"id":257828037,"uuid":"850131344","full_name":"tyfiero/script-o-matic","owner":"tyfiero","description":null,"archived":false,"fork":false,"pushed_at":"2024-08-31T01:41:13.000Z","size":81,"stargazers_count":9,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-03T04:33:06.714Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tyfiero.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-31T00:27:12.000Z","updated_at":"2024-10-22T19:36:59.000Z","dependencies_parsed_at":"2024-10-16T07:05:35.013Z","dependency_job_id":"2c0c1625-706d-4eb2-9d83-ee637851dd88","html_url":"https://github.com/tyfiero/script-o-matic","commit_stats":null,"previous_names":["tyfiero/script-o-matic"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tyfiero%2Fscript-o-matic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tyfiero%2Fscript-o-matic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tyfiero%2Fscript-o-matic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tyfiero%2Fscript-o-matic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tyfiero","download_url":"https://codeload.github.com/tyfiero/script-o-matic/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254281946,"owners_count":22045058,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-16T07:02:02.436Z","updated_at":"2025-05-15T05:31:28.849Z","avatar_url":"https://github.com/tyfiero.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# 🏭 Script-O-Matic\n\nWelcome to Script-O-Matic, your friendly neighborhood Python script generator! 🐍✨\n\n## 🎯 What is Script-O-Matic?\n\nScript-O-Matic is a CLI tool that turns your ideas into fully functional Python scripts. It uses structured output from the OpenAI API to generate scripts that are both creative and functional, as well as DSPy to refine your query to make it more specific and actionable. Check out the /example-scripts folder for some examples of what Script-O-Matic can make, feel free to add to it.\n\n## 🚀 Features\n\n- Generate custom Python scripts based on your prompts\n- Get inspiration for script ideas with `--inspo`\n- Automatic package installation\n- Interactive mode for script refinement\n\n## 🛠 Installation\n\nFirst, make sure you have installed Python 3.11 or later. Then, you can install Script-O-Matic using pip:\n\n```bash\npip install scriptomatic\n```\n\n## 🔑 Setup\n\nYeah, you're gonna need an OpenAI API key. You can get one from OpenAI's website.\n\n\"But Ty, I don't want to use OpenAI, Claude is better at coding!\" I agree with you. But Claude doesn't support structured outputs yet. When it does make a PR plz.\n\nSet it as an environment variable:\n\n```bash\nexport OPENAI_API_KEY='your-api-key-here'\n```\n\nOr, for the Windows wizards out there:\n\n```bash\nset OPENAI_API_KEY=your-api-key-here\n```\n\n## 🎭 Usage\n\n### CLI Magic\n\nGenerate a script with a simple prompt:\n\n```bash\nscriptomatic \"Create a script that converts a jpg to a png\"\n```\n\n### Need Inspiration?\n\nGet inspired with the `--inspo` flag, which creates five script ideas from your fuzzy idea:\n\n```bash\nscriptomatic --inspo\n```\n\n### Generate and test the script in a loop\n\nScript-O-Matic will keep trying to run the script until it gets it right, with a human-in-the-loop to help refine the script.\n\n```bash\nscriptomatic \"Web scraper for cat facts\" --loop\n```\n\n### Let Script-O-Matic keep trying until it gets it right\n\nCareful with this one. It's essentially an infinite loop until it gets it right, or you kill it with ctrl+c.\n\n```bash\nscriptomatic \"Calculate prime numbers\" --autoloop\n```\n\n### Python Usage\n\nThe Scriptomatic class can be imported and used in your Python scripts and has a whole host of methods for generating scripts and getting inspiration. Everything in the project is modular and extensible, so you can customize Script-O-Matic to your heart's content.\n\n```python\nfrom scriptomatic import Scriptomatic\n\nscriptomatic = Scriptomatic(model=\"gpt-4o-mini\", temperature=0.6)\n\nscriptomatic.generate_script(\"Create a script that builds scripts\")\n```\n\n## 🌟 Contributing\n\nFound a bug? Do you have an idea for an enchanting new feature? Let me know! Open an issue or submit a pull request here on GitHub.\n\n## 📜 License\n\nScript-O-Matic is released under the MIT License. Do whatever you want with it!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftyfiero%2Fscript-o-matic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftyfiero%2Fscript-o-matic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftyfiero%2Fscript-o-matic/lists"}