{"id":13504794,"url":"https://github.com/aio-libs/create-aio-app","last_synced_at":"2025-03-29T22:31:04.852Z","repository":{"id":33020282,"uuid":"149778326","full_name":"aio-libs/create-aio-app","owner":"aio-libs","description":"The boilerplate for aiohttp. Quick setup for your asynchronous web service.","archived":false,"fork":false,"pushed_at":"2023-11-25T01:47:03.000Z","size":1370,"stargazers_count":313,"open_issues_count":42,"forks_count":88,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-03-17T11:04:18.062Z","etag":null,"topics":["aio","aiohttp","asyncio","boilerplate","cookiecutter","cookiecutter-template","good-first-issue","help-wanted","postgres","python"],"latest_commit_sha":null,"homepage":"https://create-aio-app.readthedocs.io/","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/aio-libs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-09-21T14:56:57.000Z","updated_at":"2025-03-15T23:02:02.000Z","dependencies_parsed_at":"2023-11-25T02:28:52.117Z","dependency_job_id":"bac4d7f5-3453-4866-ba6d-50f344ded68d","html_url":"https://github.com/aio-libs/create-aio-app","commit_stats":{"total_commits":213,"total_committers":29,"mean_commits":7.344827586206897,"dds":0.6338028169014085,"last_synced_commit":"66e6418ec33e090fa16c589a0e7d22bfceb8e75a"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aio-libs%2Fcreate-aio-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aio-libs%2Fcreate-aio-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aio-libs%2Fcreate-aio-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aio-libs%2Fcreate-aio-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aio-libs","download_url":"https://codeload.github.com/aio-libs/create-aio-app/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246254077,"owners_count":20747946,"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":["aio","aiohttp","asyncio","boilerplate","cookiecutter","cookiecutter-template","good-first-issue","help-wanted","postgres","python"],"created_at":"2024-08-01T00:00:51.533Z","updated_at":"2025-03-29T22:31:03.646Z","avatar_url":"https://github.com/aio-libs.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":["Misc"],"readme":"# Create aio app\n\n\n[![Build Status](https://travis-ci.com/aio-libs/create-aio-app.svg?branch=master)](https://travis-ci.com/aio-libs/create-aio-app)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n[![Gitter chat](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/aio-libs/Lobby)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-green.svg)](https://github.com/aio-libs/create-aio-app/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)\n[![PyPI version](https://badge.fury.io/py/create-aio-app.svg)](https://badge.fury.io/py/create-aio-app)\n\nThe tool that lets you bootstrap aiohttp application with best practices ready for development.\n\n**Here is a screenshot of our interfaces**\n![Example](https://raw.githubusercontent.com/aio-libs/create-aio-app/master/assets/assets.png)\n\n## Installation\n\nRequires python3.6 - python3.7 and docker-compose\n\n```bash\npip install create-aio-app\n```\n\n## Usage\n\n```bash\ncreate-aio-app my_project\n```\n\nIf you want to use interactive mode enter the next command:\n\n```bash\ncreate-aio-app\n```\n\nThis will create a new directory called `my_project`.\nTo start you new project run the next commands:\n\n```bash\ncd my_project\n\nmake run # start your project\n```\n\n[Here is a link to all the make commands.](https://create-aio-app.readthedocs.io/pages/commands.html)\n\n\nThen, navigate in your browser to `http://localhost:8080/`\n\n## Salient Features\n\n- [aiohttp](https://aiohttp.readthedocs.io/en/stable/) - the best python framework :)\n- [mypy](https://mypy.readthedocs.io/en/latest/) - optional static typing\n- [pytest](https://pytest.readthedocs.io/en/latest/) - unit tests\n- [flake8](https://flake8.readthedocs.io/en/latest/) - linter\n- [black](https://black.readthedocs.io/en/latest/) - code formatter\n- [trafaret](https://trafaret.readthedocs.io/en/latest/) - data validation\n- [aio devtools](https://github.com/aio-libs/aiohttp-devtools) - developer tools\n- [aiohttp debug toolbar](https://github.com/aio-libs/aiohttp-debugtoolbar) - tool for debugging\n- [postgres](https://www.postgresql.org/) - storage\n- [alembic](https://alembic.sqlalchemy.org/en/latest/tutorial.html) - database migration tool\n- [sqlAlchemy](https://www.sqlalchemy.org/) - orm\n- [sphinx](http://www.sphinx-doc.org/en/master/) - docs\n- [docker-compose](https://docs.docker.com/compose/) - tool for defining and running multi-container Docker applications\n- [py-spy](https://github.com/benfred/py-spy) - Sampling profiler for Python programs\n\n## Options\n\n`--without-postgres` - remove postgres and all of its requirements\n\n`--redis` - add redis to the template\n\n`--uvloop` - uvloop event loop for aiohttp\n\n## Contributing\n\n`create-aio-app` is a boilerplate from aiohttp community for aiohttp \ncommunity. Feel free to make any suggestions on the issues or \ncreate a pull request. We will be very happy 😀. \nSee [CONTRIBUTING.md](https://github.com/aio-libs/create-aio-app/blob/master/CONTRIBUTING.md) for more information about \nhow to contribute to `create-aio-app`.\n\n## License\n\nCreate aio App is an open source software \u003ca href=\"https://github.com/aio-libs/create-aio-app/blob/master/LICENSE\"\u003eavailable under the MIT license\u003c/a\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faio-libs%2Fcreate-aio-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faio-libs%2Fcreate-aio-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faio-libs%2Fcreate-aio-app/lists"}