{"id":22555183,"url":"https://github.com/pythonicforge/dev-craft","last_synced_at":"2025-06-16T10:37:23.445Z","repository":{"id":166409910,"uuid":"549013158","full_name":"pythonicforge/Dev-Craft","owner":"pythonicforge","description":"A CLI tool to automate the setup of development environments, create GitHub repositories, and generate comprehensive project READMEs using AI.","archived":false,"fork":false,"pushed_at":"2025-01-27T16:55:10.000Z","size":73,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-03-23T20:51:18.286Z","etag":null,"topics":["automation","clitool","githubapi","python","readmegenerator"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pythonicforge.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2022-10-10T14:36:51.000Z","updated_at":"2025-01-27T16:55:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"4682a10c-e3e6-4bcb-9a0c-f632d3ff106a","html_url":"https://github.com/pythonicforge/Dev-Craft","commit_stats":null,"previous_names":["heyyrxjesh/workspace-automater","heyyrxjesh/dev-craft","pythonicforge/dev-craft"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pythonicforge%2FDev-Craft","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pythonicforge%2FDev-Craft/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pythonicforge%2FDev-Craft/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pythonicforge%2FDev-Craft/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pythonicforge","download_url":"https://codeload.github.com/pythonicforge/Dev-Craft/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248094554,"owners_count":21046767,"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":["automation","clitool","githubapi","python","readmegenerator"],"created_at":"2024-12-07T19:07:02.202Z","updated_at":"2025-04-09T19:00:26.640Z","avatar_url":"https://github.com/pythonicforge.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# _Dev-Craft_\n![image](https://github.com/pythonicforge/Dev-Craft/assets/168327453/62de494c-2adf-48d3-8f54-74bc2bda1516)\n\n_Dev-Craft is a powerful CLI tool designed to streamline the setup and management of development environments for various types of projects. It ensures that necessary software is installed, creates GitHub repositories, sets up project directories, and generates initial README files using AI._\n\n\n### _Features_\n\n- _Automatically installs necessary software (VSCode, Git, Python)_\n- _Creates GitHub repositories_\n- _Sets up project directories with common subfolders_\n- _Generates comprehensive README files using AI_\n- _Installs base packages for various project templates_\n- _Opens project in VSCode_\n\n\n### _Installation_\n\n_Prerequisites: Python 3.6+_\n\n1. _**Clone the repository:**_\n   ```bash\n   git clone https://github.com/yourusername/dev-craft.git\n   cd dev-craft\n   ```\n\n2. _**Run the install script:**_\n   ```bash\n   chmod +x install.sh\n   ./install.sh\n   ```\n\n3. _**Install dependencies manually (if not using the install script):**_\n   ```bash\n   pip install .\n   ```\n### _Usage/Examples_\n\n_After installation, you can use the `dev-craft` command to initialize your projects. The CLI provides various commands to automate the setup process._\n\n```bash\ndev-craft create_repo my-new-project \"A description of my new project\" \"web application\" --private --env-file /path/to/.env\n```\n\n_This command will:_\n\n- _Create a new private GitHub repository named `my-new-project`_\n- _Set up a project folder with necessary subfolders_\n- _Generate a comprehensive README file_\n- _Initialize a Git repository and push the initial commit_\n- _Create a Python virtual environment_\n- _Install base packages for a web application_\n- _Open the project in VSCode_\n### _Project Structure_\n\n_After running `dev-craft`, your project directory will look like this:_\n\n```\nmy-new-project/\n├── README.md\n├── env/\n├── src/\n├── tests/\n└── docs/\n```\n\n### _Run Locally_\n_Follow the steps below to run Dev-Craft locally_\n\n1. **_Clone the project_**\n\n```bash\n  git clone https://github.com/pythonicforge/Dev-Craft.git\n```\n\n2. **_Go to the project directory_**\n\n```bash\n  cd Dev-Craft\n```\n\n3. **_Install dependencies_**\n\n```bash\n  pip install -r reuqirements.txt\n```\n\n4. **_Run the App_**\n\n```bash\n  python dev_craft/cli.py --help\n```\n\n\n### _Environment Variables_\n\n_Ensure you have a `.env` file in the root of your project or specify its path using the `--env-file` option. The `.env` file should contain the following variables:_\n\n```\nGITHUB_TOKEN = \u003cyour_github_personal_access_token\u003e\nEMAIL_ADDRESS = \u003cyour_email_address\u003e\nPASSWORD = \u003cyour_password\u003e\n```\n\n\n### _Commands_\n\n#### `create_repo`\n\n_Creates a new GitHub repository and sets up the project directory._\n\n_**Arguments:**_\n- _`repo_name`: Name of the repository_\n- _`description`: Description of the repository_\n- _`template`: Project template type (choose from: \"web application\", \"data science\", \"machine learning\")_\n\n**Options:**\n- _`--private`: Create a private repository_\n- _`--env-file`: Path to the `.env` file (default: `.env`)_\n### _Tech Stack_\n\n_**Client:** Python-argparse, Shell scripting_\n\n_**Server:** Python_\n\n\n### _Contributing_\n\n_We welcome contributions to Dev-Craft! Please follow these steps to contribute:_\n\n1. _Fork the repository_\n2. _Create a new branch (`git checkout -b feature-branch`)_\n3. _Make your changes_\n4. _Commit your changes (`git commit -m 'Add some feature'`)_\n5. _Push to the branch (`git push origin feature-branch`)_\n6. _Open a pull request_\n\n\n\n### License\n\n_This project is licensed under the MIT License. See the [LICENSE](https://github.com/pythonicforge/Dev-Craft/blob/main/LICENSE) file for details._\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpythonicforge%2Fdev-craft","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpythonicforge%2Fdev-craft","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpythonicforge%2Fdev-craft/lists"}