{"id":13736038,"url":"https://github.com/falcopackages/falco-cli","last_synced_at":"2025-05-16T03:06:22.445Z","repository":{"id":212675909,"uuid":"732068852","full_name":"falcopackages/falco-cli","owner":"falcopackages","description":"Enhance your Django developer experience: CLI and Guides for the Modern Django Developer.","archived":false,"fork":false,"pushed_at":"2024-12-31T09:14:42.000Z","size":3265,"stargazers_count":387,"open_issues_count":4,"forks_count":20,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-05-13T13:11:31.161Z","etag":null,"topics":["build-in-public","cookiecutter","cookiecutter-template","django","hatch","htmx","starter-project"],"latest_commit_sha":null,"homepage":"https://falco.oluwatobi.dev/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/falcopackages.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":"2023-12-15T15:05:56.000Z","updated_at":"2025-05-03T07:06:13.000Z","dependencies_parsed_at":"2024-12-13T14:31:00.644Z","dependency_job_id":"37bb40f2-5626-48fd-b746-e3182a7cd74b","html_url":"https://github.com/falcopackages/falco-cli","commit_stats":null,"previous_names":["tobi-de/falco","falcopackages/falco-cli"],"tags_count":68,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/falcopackages%2Ffalco-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/falcopackages%2Ffalco-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/falcopackages%2Ffalco-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/falcopackages%2Ffalco-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/falcopackages","download_url":"https://codeload.github.com/falcopackages/falco-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254092648,"owners_count":22013290,"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":["build-in-public","cookiecutter","cookiecutter-template","django","hatch","htmx","starter-project"],"created_at":"2024-08-03T03:01:14.810Z","updated_at":"2025-05-16T03:06:17.435Z","avatar_url":"https://github.com/falcopackages.png","language":"Python","readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://falco.oluwatobi.dev/\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/falcopackages/falco/main/docs/_static/falco-logo.svg\" alt=\"falco logo\" height=\"200\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003e\n  \u003ca href=\"https://falco.oluwatobi.dev\"\u003eFalco\u003c/a\u003e\n  \u003cp\u003eAn opinionated toolkit for a modern Django development experience\u003c/p\u003e\n\u003c/h1\u003e\n\n[![CI](https://github.com/Tobi-De/falco/actions/workflows/ci.yml/badge.svg)](https://github.com/Tobi-De/falco/actions/workflows/ci.yml)\n[![Publish Python Package](https://github.com/Tobi-De/falco/actions/workflows/publish.yml/badge.svg)](https://github.com/Tobi-De/falco/actions/workflows/publish.yml)\n[![Documentation](https://readthedocs.org/projects/falco-cli/badge/?version=latest\u0026style=flat)](https://beta.readthedocs.org/projects/falco-cli/builds/?version=latest)\n[![pypi](https://badge.fury.io/py/falco-cli.svg)](https://pypi.org/project/falco-cli/)\n[![Hatch project](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg)](https://github.com/pypa/hatch)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/Tobi-De/falco/blob/main/LICENSE)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/falco-cli)](https://pypi.org/project/falco-cli/)\n[![PyPI - Versions from Framework Classifiers](https://img.shields.io/pypi/frameworkversions/django/falco-cli)](https://pypi.org/project/falco-cli/)\n[![PyPI - Downloads](https://img.shields.io/pypi/dm/falco-cli)](https://pypistats.org/packages/falco-cli)\n\n\u003e [!WARNING]\n\u003e The falco CLI isn't stable at the moment; stability is expected with the 1.0.0 release. I'm still making numerous changes quite frequently. If you're currently using it, remember to run `pip install --upgrade falco-cli` from time to time.\n\nFalco is a Django-centric toolkit designed to enhance the development experience. The CLI offers commands for initiating new projects, generating simple CRUD views for rapid prototyping, and more. Additionally, it provides a collection of guides to address common issues in web development specifically tailored to Django.\n\n\u003c!-- [![Read the full documentation](https://img.shields.io/badge/Read%20The%20full%20Documentation-blue?style=for-the-badge\u0026logo=ReadTheDocs)](https://falco.oluwatobi.dev) --\u003e\n\n\n## The CLI\n\nThis is a set of commands to help you throughout the lifecycle of your django project development, from bootstrapping a new project using modern tools like [htmx](https://htmx.org), [hatch](https://github.com/pypa/hatch), [tailwindcss](https://tailwindcss.com/), to generating CRUD views for your models and a few utilities that might help during deployment.\n\nFor a brief introduction to the user experience of the CLI, visit this [page](https://falco.oluwatobi.dev/the_cli/usage.html).\n\u003c!-- [![The CLI full documentation](https://img.shields.io/badge/Read%20The%20CLI%20Documentation-blue?style=for-the-badge\u0026logo=ReadTheDocs)](https://falco.oluwatobi.dev/the_cli/) --\u003e\n\n\n```sh\npip install falco-cli\n```\n\n- [start-project](https://falco.oluwatobi.dev/the_cli/start_project/index.html): Initialize a new django project the falco way.\n- [update-project](https://falco.oluwatobi.dev/the_cli/start_project/index.html): Update your project to get the latest falco features (**experimental**).\n- [start-app](https://falco.oluwatobi.dev/the_cli/start_app.html): Initialize a new django app the falco way.\n- [crud](https://falco.oluwatobi.dev/the_cli/crud.html): Generate CRUD (Create, Read, Update, Delete) views for a model.\n- [install-crud-utils](https://falco.oluwatobi.dev/the_cli/crud.html#install-crud-utils): Install utils necessary for CRUD views.\n- [work](https://falco.oluwatobi.dev/the_cli/work.html): Run all the services required to run your django project in parallel with a single command. (development only)\n- [htmx](https://falco.oluwatobi.dev/the_cli/htmx.html): Download a local copy of the latest version of htmx.\n- [htmx-ext](https://falco.oluwatobi.dev/the_cli/htmx.html#falco-htmx-ext): Download one of htmx extensions.\n- [sync-dotenv](https://falco.oluwatobi.dev/the_cli/sync_dotenv.html): Synchronize the `.env` file with the `.env.template` file.\n- [rm-migrations](https://falco.oluwatobi.dev/the_cli/migrations.html): Remove all migrations for the specified applications directory. (development only)\n- [reset-migrations](https://falco.oluwatobi.dev/the_cli/migrations.html#reset-migrations): Delete and recreate all migrations. (development only)\n\n\n**Templates**\n\n- [tailwind](https://github.com/Tobi-De/falco_tailwind) (default)\n- [bootstrap](https://github.com/Tobi-De/falco_bootstrap)\n\n## The guides\n\n\u003e [!NOTE]\n\u003e These are currently a work in progress. Most of them are half-written or not written at all. I hope\n\u003e to get them in a usable state ~~by the end of january 2024~~ as soon as I can. To receive updates [subscribe to this discussion](https://github.com/Tobi-De/falco/discussions/39) or\n\u003e follow me on [x](https://twitter.com/tobidegnon) or [mastodon](https://fosstodon.org/@tobide)\n\nIf you don't find any use of the CLI, I hope you will in these guides. This is a collection of guides that address common issues in web development, specifically tailored to Django. Each guide provides solutions, patterns, and approaches that are relevant to Django projects. It is similar to the [Django topic guides](https://docs.djangoproject.com/en/5.0/topics/), but instead of focusing on components of the framework like `forms`, `models`, `views`, etc., it focuses on more general topics like `task queues`, `deployment`, `realtime`, etc.\n\n\u003c!--\n[![The full Guides](https://img.shields.io/badge/Read%20The%20Full%20Guides-blue?style=for-the-badge\u0026logo=ReadTheDocs)](https://falco.oluwatobi.dev/guides/) --\u003e\n\n\n\u003c!-- GUIDES-LIST:START --\u003e\n- [Interactive user interfaces](https://falco.oluwatobi.dev/guides/interactive_user_interfaces.html)\n- [Task Queues and Schedulers](https://falco.oluwatobi.dev/guides/task_queues_and_schedulers.html)\n- [Writing documentation](https://falco.oluwatobi.dev/guides/writing_documentation.html)\n- [Writing tests](https://falco.oluwatobi.dev/guides/writing_tests.html)\n- [Logging and monitoring](https://falco.oluwatobi.dev/guides/logging_and_monitoring.html)\n- [The ultimate deployment guide](https://falco.oluwatobi.dev/guides/deployment.html)\n- [Optimizing Database Access](https://falco.oluwatobi.dev/guides/optimizing_database_access.html)\n- [Business logic in django](https://falco.oluwatobi.dev/guides/avoiding_god_models.html)\n- [Dynamic Model Schema](https://falco.oluwatobi.dev/guides/dynamic_model_schema.html)\n- [Realtime in Django: Websockets, SSE, Polling](https://falco.oluwatobi.dev/guides/realtime.html)\n- [Permissions and authorizations](https://falco.oluwatobi.dev/guides/permissions_and_authorization.html)\n- [Database Tips: Backup, Scaling, Triggers, and More](https://falco.oluwatobi.dev/guides/database_tips.html)\n- [Managing Multi-tenancy in Django](https://falco.oluwatobi.dev/guides/multitenancy.html)\n- [Async Coding in Django](https://falco.oluwatobi.dev/guides/writing_async_code.html)\n- [Use Sqlite in production](https://falco.oluwatobi.dev/guides/use_sqlite_in_production.html)\n- [Running your project in a single container](https://falco.oluwatobi.dev/guides/running_project_in_a_container.html)\n- [Tips and extra](https://falco.oluwatobi.dev/guides/tips_and_extra.html)\n\u003c!-- GUIDES-LIST:END --\u003e\n\n## Acknowledgements\n\nFalco is inspired by (and borrows elements from) some excellent open source projects:\n\n- [cookiecutter-django](https://github.com/cookiecutter/cookiecutter-django)\n- [fuzzy-couscous](https://github.com/Tobi-De/fuzzy-couscous) (predecessor of falco)\n- [django-hatch-startproject](https://github.com/oliverandrich/django-hatch-startproject)\n- [django-unicorn](https://github.com/adamghill/django-unicorn) (Inspiration for the logo)\n- [neapolitan](https://github.com/carltongibson/neapolitan)\n- [django-base-site](https://github.com/epicserve/django-base-site)\n- [django-twc-project](https://github.com/westerveltco/django-twc-project)\n\n## Contributors\n\u003c!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --\u003e\n[![All Contributors](https://img.shields.io/badge/all_contributors-9-orange.svg?style=flat-square)](#contributors-)\n\u003c!-- ALL-CONTRIBUTORS-BADGE:END --\u003e\n\n\u003c!-- contributors:start --\u003e\nThanks to the following wonderful people [emoji key](https://allcontributors.org/docs/en/emoji-key) who have helped build `falco`.\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"http://oluwatobi.dev\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/40334729?v=4?s=100\" width=\"100px;\" alt=\"Tobi DEGNON\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eTobi DEGNON\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/Tobi-De/falco/commits?author=Tobi-De\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/Tobi-De/falco/commits?author=Tobi-De\" title=\"Documentation\"\u003e📖\u003c/a\u003e \u003ca href=\"https://github.com/Tobi-De/falco/commits?author=Tobi-De\" title=\"Tests\"\u003e⚠️\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/hammadarshad1\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/45298916?v=4?s=100\" width=\"100px;\" alt=\"Muhammad Hammad\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eMuhammad Hammad\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#ideas-hammadarshad1\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/mathiasag7\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/50689712?v=4?s=100\" width=\"100px;\" alt=\"mathiasag7\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003emathiasag7\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/Tobi-De/falco/commits?author=mathiasag7\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"http://mainlydata.kubadev.com\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/403435?v=4?s=100\" width=\"100px;\" alt=\"Richard Shea\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eRichard Shea\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/Tobi-De/falco/commits?author=shearichard\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://lexumsoft.com/\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/96701299?v=4?s=100\" width=\"100px;\" alt=\"Waqar Khan\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eWaqar Khan\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/Tobi-De/falco/commits?author=786raees\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/tissieres\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/2410978?v=4?s=100\" width=\"100px;\" alt=\"tissieres\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003etissieres\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#financial-tissieres\" title=\"Financial\"\u003e💵\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://lepture.com\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/290496?v=4?s=100\" width=\"100px;\" alt=\"Hsiaoming Yang\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eHsiaoming Yang\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/Tobi-De/falco/issues?q=author%3Alepture\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/aimedey19\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/89580257?v=4?s=100\" width=\"100px;\" alt=\"Aimé An-Nyong DEGBEY\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAimé An-Nyong DEGBEY\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#ideas-aimedey19\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/earthcomfy\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/66206865?v=4?s=100\" width=\"100px;\" alt=\"Hana Belay\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eHana Belay\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/Tobi-De/falco/commits?author=earthcomfy\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\u003c!-- contributors:end --\u003e\n","funding_links":[],"categories":["Projects","Third Party Packages 📦 \u003ca name = \"tools\"\u003e\u003c/a\u003e"],"sub_categories":["Boilerplate","Templates"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffalcopackages%2Ffalco-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffalcopackages%2Ffalco-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffalcopackages%2Ffalco-cli/lists"}