{"id":20924,"library":"ansible-creator","title":"Ansible Creator","description":"A CLI tool for scaffolding Ansible Content (roles, playbooks, collections, etc.). Currently at version 26.4.2, with frequent releases following Ansible's release cadence.","status":"active","version":"26.4.2","language":"python","source_language":"en","source_url":"https://github.com/ansible/ansible-creator","tags":["ansible","scaffolding","cli","devops"],"install":[{"cmd":"pip install ansible-creator","lang":"bash","label":"PyPI"},{"cmd":"pip install ansible-creator==26.4.2","lang":"bash","label":"Specific version"}],"dependencies":[{"reason":"Required for running generated content.","package":"ansible-core","optional":true}],"imports":[{"note":"Wrong package prefix; ansible-creator uses ansible_creator, not ansible.","wrong":"from ansible.creator import AnsibleCreator","symbol":"AnsibleCreator","correct":"from ansible_creator.cli import AnsibleCreator"}],"quickstart":{"code":"from ansible_creator.cli import AnsibleCreator\nimport os\n\n# Initialize the creator (uses environment vars for config)\ncreator = AnsibleCreator()\n# Scaffold a new Ansible role\ncreator.run(['init', '--type', 'role', '--path', './my_role'])\n","lang":"python","description":"Initialize AnsibeCreator and scaffold a role."},"warnings":[{"fix":"Update scripts to use 'ansible-creator' command.","message":"In version 25.x, the CLI entry point was moved from 'ansible-creator' (with hyphen) to 'ansible-creator' (underscore is not used). Scripts relying on the old command name may fail.","severity":"breaking","affected_versions":"<25.0.0"},{"fix":"Always specify --type (role, playbook, collection, etc.).","message":"The init command required '--type' argument is mandatory; omitting it raises a TypeError.","severity":"breaking","affected_versions":"All"},{"fix":"Replace --output with --path.","message":"The '--output' flag has been deprecated in favor of '--path'. Using --output will still work but emits a warning and may be removed in future.","severity":"deprecated","affected_versions":">=25.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use 'from ansible_creator.cli import AnsibleCreator' (underscore only).","cause":"Trying to import using the wrong package name (e.g., ansible.creator or ansible_creator with hyphen).","error":"ModuleNotFoundError: No module named 'ansible_creator'"},{"fix":"Provide --type: e.g., 'ansible-creator init --type role --path ./new_role'.","cause":"Calling init without the --type argument.","error":"TypeError: init() missing 1 required positional argument: 'type'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}