{"id":29021424,"url":"https://github.com/tribecabrasil/tribeca-django-init","last_synced_at":"2026-05-06T08:32:33.321Z","repository":{"id":301076599,"uuid":"1008086093","full_name":"tribecabrasil/tribeca-django-init","owner":"tribecabrasil","description":"Tribeca Django Init is a modern, interactive CLI for bootstrapping Django projects with production-ready structure, automation, and best practices. Designed for seamless integration with Multi-Component Platforms (MCPs), AI agents, and CI/CD pipelines, it offers both human-friendly prompts and a robust JSON mode for headless, scriptable workflows.","archived":false,"fork":false,"pushed_at":"2025-07-07T04:32:10.000Z","size":67,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-07T04:36:07.813Z","etag":null,"topics":["agents-md","ai-agents","automation","bootstrap","cli","devtools","django","mcp","mcp-tools","modern-stack","project-template","python","rest-api","tribecamp"],"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/tribecabrasil.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2025-06-25T02:25:17.000Z","updated_at":"2025-07-07T04:29:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"252a6b93-7d05-45d1-9082-138513ab45b1","html_url":"https://github.com/tribecabrasil/tribeca-django-init","commit_stats":null,"previous_names":["tribecabrasil/tribeca-django-init"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tribecabrasil/tribeca-django-init","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tribecabrasil%2Ftribeca-django-init","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tribecabrasil%2Ftribeca-django-init/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tribecabrasil%2Ftribeca-django-init/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tribecabrasil%2Ftribeca-django-init/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tribecabrasil","download_url":"https://codeload.github.com/tribecabrasil/tribeca-django-init/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tribecabrasil%2Ftribeca-django-init/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32684643,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T02:33:58.958Z","status":"ssl_error","status_checked_at":"2026-05-06T02:33:39.611Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["agents-md","ai-agents","automation","bootstrap","cli","devtools","django","mcp","mcp-tools","modern-stack","project-template","python","rest-api","tribecamp"],"created_at":"2025-06-26T02:05:35.045Z","updated_at":"2026-05-06T08:32:33.316Z","avatar_url":"https://github.com/tribecabrasil.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tribeca Django Init — MCPs \u0026 Agents Ready 🚀🤖\n\n[![Build Status](https://img.shields.io/github/actions/workflow/status/tribecabrasil/tribeca-django-init/ci.yml?branch=main)](https://github.com/tribecabrasil/tribeca-django-init/actions)\n[![Coverage Status](https://img.shields.io/codecov/c/github/tribecabrasil/tribeca-django-init)](https://codecov.io/gh/tribecabrasil/tribeca-django-init)\n[![License](https://img.shields.io/github/license/tribecabrasil/tribeca-django-init)](LICENSE)\n[![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/downloads/)\n[![Django](https://img.shields.io/badge/django-5.2%2B-green)](https://www.djangoproject.com/)\n\n\u003e **The next-gen Django project bootstrapper for humans, CI/CD, and AI agents.**\n\u003e \n\u003e **Full compatibility with Multi-Component Platforms (MCPs), automation, and intelligent workflows.**\n\n---\n\n## 🚀 Overview\nTribeca Django Init is a fully interactive CLI that automates the creation of robust Django projects, following the latest standards for API-first, maintainable, and scalable web applications.\n\n---\n\n## 🏷️ Recommended Tags\n\ndjango, cli, bootstrap, automation, mcp, ai-agents, devops, ci-cd, rest-api, production-ready, project-generator, python, template, best-practices, internationalization, i18n, scaffold, json, modern\n\n---\n\n## 📢 Project Description\n\n**Short:**\n\u003e Next-gen Django project bootstrapper — interactive, agent-ready, CI/CD-friendly, and production-focused. Full support for MCPs, automation, and best practices.\n\n**Long:**\n\u003e Tribeca Django Init is a modern, interactive CLI for bootstrapping Django projects with production-ready structure, automation, and best practices. Designed for seamless integration with Multi-Component Platforms (MCPs), AI agents, and CI/CD pipelines, it offers both human-friendly prompts and a robust JSON mode for headless, scriptable workflows.\n\u003e\n\u003e - Dual-mode CLI: interactive for humans, JSON/flags for agents and automation\n\u003e - Compatible with AI agents and modern DevOps workflows\n\u003e - Instantly creates projects with Django REST, i18n, and scalable settings\n\u003e - Standardizes best practices for security, maintainability, and deployment\n\u003e - Easily extendable and future-proof for evolving automation needs\n\n---\n\n- Fast bootstrap with numbered choices, emojis, and clear prompts\n- Installs Django 5.2+, Django REST Framework, and a modern stack\n- Modular settings structure: `settings/base.py.tpl` (base), `settings/dev.py.tpl` (development), `settings/prod.py.tpl` (production)\n- Uses django-environ and .env for environment-based configuration\n- Automated quality tools and CI/CD ready\n- Documentation and templates in English, ready for international teams\n\n---\n\n## 🛠️ Stack\n- **Python** 3.12+\n- **Django** 5.2+\n- **Django REST Framework**\n- **PostgreSQL** (default, easily swappable)\n- **pytest-django**, **black**, **isort**, **pre-commit**\n- **Whitenoise**, **gunicorn**, **django-environ**\n\n---\n\n## 📦 Installation\n\n```bash\n# Clone the repo\n git clone https://github.com/tribecabrasil/tribeca-django-init.git\n cd tribeca-django-init\n\n# (Recommended) Create and activate a virtualenv\n python3 -m venv .venv\n source .venv/bin/activate\n\n# Install in editable mode\n pip install -e .\n\n# Install and configure pre-commit hooks\n pip install pre-commit black isort flake8\npre-commit install\n```\n\n### Using pre-commit\n\nRun all hooks on every file:\n\n```bash\npre-commit run --all-files\n```\n\nThe hooks will format and lint your code automatically before each commit.\nThese style checks also run in the CI workflow to keep contributions consistent.\nThe setup also checks if [review/indexReview.md](review/indexReview.md) was modified.\nAlways registre suas revisões no topo desse arquivo antes de commitar.\n\n---\n\n## 💡 Usage\n\n### Human Mode (Interactive)\n\nTo use the CLI in the traditional way, simply run:\n\n```bash\npython -m init_django.cli_user\n```\n\nYou will be guided by interactive prompts, with friendly messages and visual context.\n\n### MCP / JSON Mode (Automation, Agents)\n\nFor integration with MCPs, automation, or agents, use the non-interactive/JSON mode:\n\n```bash\npython -m init_django.cli_mcp --json --venv recreate --install-deps yes --django-version 5.2.3 --git-init yes --project yes --settings yes --app-name users --app-create yes --migrate yes --readme yes\n```\n\nEach step will emit a structured JSON line, for example:\n\n```json\n{\"event\": \"virtualenv\", \"status\": \"success\", \"message\": \".venv recreated\", \"data\": {\"path\": \"/project/path/.venv\"}, \"ts\": \"2025-06-25T07:00:00Z\"}\n```\n\nSee more examples and explanations in [docs/mcps_documentation.md](docs/mcps_documentation.md).\n- The CLI will guide you through each step: venv, dependencies, git, project, settings, app, migrations, and docs\n\n---\n\n## 🔧 Troubleshooting\n\n- **Command not found**: Ensure you have activated the virtual environment (`source .venv/bin/activate`) and installed the package in editable mode (`pip install -e .`).\n- **Test Failures**: If you are contributing and encounter test failures, please see `AGENTS.md` for detailed guidance on debugging common issues related to CLI input alignment and Django settings.\n\n---\n\n## 🏗️ Example Project Structure\n```text\nconfig/\n  settings/\n    __init__.py\n    base.py  # Generated from settings/base.py.tpl\n    dev.py   # Generated from settings/dev.py.tpl\n    prod.py  # Generated from settings/prod.py.tpl\nmanage.py\n.venv/\n.git/\nPython.gitignore  # from init_django/templates/Python.gitignore\nREADME.md\n.env  # Your environment variables (see .env.example)\n```\n\n### Settings Templates\n- All Django settings are generated from templates in `init_django/templates/`:\n  - `settings/base.py.tpl` → `config/settings/base.py`\n  - `settings/dev.py.tpl` → `config/settings/dev.py`\n  - `settings/prod.py.tpl` → `config/settings/prod.py`\n- The CLI will copy and configure these automatically.\n\n### Environment Variables \u0026 django-environ\n- The project uses [django-environ](https://django-environ.readthedocs.io/) for configuration.\n- The CLI can automatically copy `.env.example` to `.env` after project creation.\n- You can also manually create the file if preferred.\n- Typical variables:\n  - `DJANGO_SECRET_KEY`, `DEBUG`, `DJANGO_ALLOWED_HOSTS`, `DATABASE_URL`, etc.\n- This approach keeps secrets and environment-specific config out of version control and enables safe, Twelve-Factor deployments.\n```\n\n---\n\n## ✨ Features\n- Interactive, emoji-powered CLI\n- Detects and reuses existing resources\n- Modern, production-ready Django setup\n- Local Python.gitignore template for Git initialization\n- DRF and quality tools included by default\n- All docs, templates, and code in English\n- Ready for CI/CD and cloud deployment\n\n---\n\n## 🤝 Contributing\nPull requests and suggestions are welcome! For major changes, please open an issue first to discuss what you would like to change.\n\n- Follow the project standards in [AGENTS.md](AGENTS.md)\n- Use English for all documentation and code\n- Update/add tests in `tests/` when relevant\n\n---\n\n## 📚 Documentation\n\n### Integration with MCPs (Multi-Component Platforms/AI agents)\nSupport and compatibility with MCPs is already under active planning. See details, examples, and roadmap in [`docs/mcps_documentation.md`](docs/mcps_documentation.md).\n\n- [README](README.md): this file\n- [AGENTS.md](AGENTS.md): standards \u0026 automation for humans and AI\n- [docs/unified_dev_ops_guide.md](docs/unified_dev_ops_guide.md): unified development \u0026 operations guide\n- [docs/](init_django/templates/docs/): API, architecture, and models templates\n- [review/](review/): arquivos de revisão no padrão `YYYY-MM-DD-descricao-curta.md`.\n  Consulte o índice rápido em [review/indexReview.md](review/indexReview.md).\n\n---\n\n## 🧑‍💻 Author\n**Flavio Paulino**  \nTribeca Digital — São Paulo, Brazil  \n[http://tribecadigital.com.br](http://tribecadigital.com.br)\n\n---\n\n## License\n[MIT](LICENSE)\n\n---\n\n## 🏷️ Suggested GitHub Topics\n\ndjango, cli, bootstrap, project-template, rest-api, python, automation, devtools, tribeca, modern-stack\n- [cookiecutter-django](https://github.com/cookiecutter/cookiecutter-django)\n- [Django Project](https://www.djangoproject.com/)\n- [PEP-257](https://peps.python.org/pep-0257/)\n\n---\n\n\u003e Generated by `Tribeca Django Init` — keep your bootstrap up to date!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftribecabrasil%2Ftribeca-django-init","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftribecabrasil%2Ftribeca-django-init","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftribecabrasil%2Ftribeca-django-init/lists"}