{"id":25862815,"url":"https://github.com/datachefhq/inception","last_synced_at":"2025-03-01T23:56:50.159Z","repository":{"id":248825341,"uuid":"829884713","full_name":"DataChefHQ/inception","owner":"DataChefHQ","description":"DataChef's project kickstarter! Reproducible, Declarative and Reliable development environments.","archived":false,"fork":false,"pushed_at":"2024-11-11T15:52:04.000Z","size":162,"stargazers_count":21,"open_issues_count":19,"forks_count":3,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-02-26T17:53:15.988Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Jinja","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/DataChefHQ.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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":"2024-07-17T07:26:57.000Z","updated_at":"2025-02-18T22:30:39.000Z","dependencies_parsed_at":"2024-09-10T10:46:43.081Z","dependency_job_id":"c8a10e14-0507-4547-bd58-084387e3aea7","html_url":"https://github.com/DataChefHQ/inception","commit_stats":null,"previous_names":["datachefhq/inception"],"tags_count":40,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataChefHQ%2Finception","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataChefHQ%2Finception/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataChefHQ%2Finception/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataChefHQ%2Finception/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DataChefHQ","download_url":"https://codeload.github.com/DataChefHQ/inception/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241439766,"owners_count":19963100,"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":[],"created_at":"2025-03-01T23:56:48.731Z","updated_at":"2025-03-01T23:56:50.133Z","avatar_url":"https://github.com/DataChefHQ.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Inception\n\n[![DataChefHQ - inception](https://img.shields.io/static/v1?label=DataChefHQ\u0026message=inception\u0026color=blue\u0026logo=github)](https://github.com/DataChefHQ/inception \"Go to GitHub repo\")\n[![Test](https://github.com/DataChefHQ/inception/workflows/Test/badge.svg)](https://github.com/DataChefHQ/inception/actions?query=workflow:\"Test\")\n[![GitHub release](https://img.shields.io/github/release/DataChefHQ/inception?include_prereleases=\u0026sort=semver\u0026color=blue)](https://github.com/DataChefHQ/inception/releases/)\n[![License](https://img.shields.io/badge/License-MIT-blue)](#license)\n\nInception is a project kickstarter (scaffolding tool), designed to\nimprove developer experience and help with fast onboarding. All the\ndecisions and options provided in these templates, are based on what\nwe use mainly in [DataChef](https://datachef.co). However, given the\nopen source nature of this project, feel free to challenge these\ndecision and help us to improve them.\n\n\u003c!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc-refresh-toc --\u003e\n**Table of Contents**\n\n- [Inception](#inception)\n  - [In Action](#in-action)\n  - [Features](#features)\n    - [Detailed Features](#detailed-features)\n  - [How to Use](#how-to-use)\n    - [Prerequisites](#prerequisites)\n    - [Initialize a New Project](#initialize-a-new-project)\n  - [Resources](#resources)\n  - [Contributing](#contributing)\n  - [License](#license)\n  - [Acknowledgments](#acknowledgments)\n\n\u003c!-- markdown-toc end --\u003e\n\n## In Action\n\n[![Install Inception](https://res.cloudinary.com/marcomontalbano/image/upload/v1731339691/video_to_markdown/images/google-drive--1emSelH7_yrp51NERaaTQ2Hkk_0omBmGA-c05b58ac6eb4c4700831b2b3070cd403.jpg)](https://drive.google.com/file/d/1emSelH7_yrp51NERaaTQ2Hkk_0omBmGA/view?usp=drive_link \"Install Inception\")\n\n## Features\n\n1. **Opinionated Configuration**: Reduces decision fatigue by\n   providing fewer, well-chosen options.\n2. **Reproducible and Declarative**: Built on [Nix](https://nixos.org)\n   and [Devenv](https://devenv.sh), ensuring reliable, reproducible\n   environments.\n3. **Multi-Language Support**: Compatible with Python, Node.js, Go,\n   and Rust.\n4. **Enhanced Development Environment**: Includes features like\n   [dotenv](https://www.dotenv.org/), [LSP](https://langserver.org/),\n   [difftastic](https://github.com/Wilfred/difftastic), and more.\n5. **DevContainer and CodeSpaces Support**: Developers don't even need\n   a local editor to begin with!\n6. **Comprehensive .gitignore**: Includes a well-crafted `.gitignore`\n   file.\n\n### Detailed Features\n\n| Feature                   | Python | Node.js | Go  | Rust |\n| ------------------------- | ------ | ------- | --- | ---- |\n| Automatic Changelog       | ✅     | ⏳      | ⏳  | ⏳   |\n| Automatic Release         | ✅     | ⏳      | ⏳  | ⏳   |\n| Automatic Versioning      | ✅     | ⏳      | ⏳  | ⏳   |\n| CI/CD                     | ✅     | ✅      | ✅  | ✅   |\n| Check code docs on commit | ✅     | ⏳      | ⏳  | ⏳   |\n| Documentation Generator   | ⏳     | ⏳      | ⏳  | ⏳   |\n| Editor Config             | ✅     | ✅      | ✅  | ✅   |\n| Generate Containers       | ✅     | ✅      | ✅  | ✅   |\n| Language Server           | ✅     | ✅      | ✅  | ✅   |\n| Pre Commit Hooks          | ✅     | ✅      | ✅  | ✅   |\n| Type Check                | ✅     | ✅      | N/A | N/A  |\n| Yaml Lint                 | ✅     | ✅      | ✅  | ✅   |\n| devcontainer              | ✅     | ✅      | ✅  | ✅   |\n| difftastic                | ✅     | ✅      | ✅  | ✅   |\n| dotenv                    | ✅     | ✅      | ✅  | ✅   |\n\n## How to Use\n\n### Prerequisites\n\nTo start working with Inception, you need:\n\n- [Devenv](https://devenv.sh/getting-started/), version 1.0.0 or higher.\n  [![Install Devenv](https://res.cloudinary.com/marcomontalbano/image/upload/v1731339790/video_to_markdown/images/google-drive--1rfU7zu3ZGXkgcoBQGZ9vnmWYaPveG0bE-c05b58ac6eb4c4700831b2b3070cd403.jpg)](https://drive.google.com/file/d/1rfU7zu3ZGXkgcoBQGZ9vnmWYaPveG0bE/view?usp=drive_link \"Install Devenv\")\n- [pipx](https://pipx.pypa.io/stable/) or\n  [copier](https://copier.readthedocs.io/)\n\n\u003e [!TIP]\n\u003e Enabling [direnv](https://direnv.net) allows you to:\n\u003e\n\u003e 1. Use your own shell configuration in `devenv` session.\n\u003e 2. Automatically integrated with your IDE (VSCode and Intellij support\n\u003e it out of the box, and for Emacs and Vim you can use suggested\n\u003e plugins below).\n\u003e\n\u003e For more information on how to enable it you can refer to [this wiki\n\u003e entry](https://github.com/DataChefHQ/inception/wiki/How-to-enable-direnv%3F).\n\n*Suggested Plguins*:\n\n1. [emacs-direnv](https://github.com/wbolster/emacs-direnv)\n2. [direnv.vim](https://github.com/direnv/direnv.vim)\n\n\u003e [!NOTE]\n\u003e While installing `devenv` for the first time, you might face the\n\u003e following known errors depending to your local setup. Following links\n\u003e aim to help you solve them quickly:\n\u003e\n\u003e - [Add user to the trusted user list](https://github.com/DataChefHQ/inception/wiki/MacOS:-add-user-to-the-trusted-user-list)\n\u003e - [Trusting git directory](https://github.com/DataChefHQ/inception/wiki/Trusting-git-directory)\n\n### Initialize a New Project\n\nFirst, create a project folder and cd into it.\n\n```bash\nmkdir awesome-project \u0026\u0026 cd awesome-project\n```\n\nUsing pipx:\n\n```bash\npipx run copier copy --trust gh:DataChefHQ/Inception .\n```\n\nIf you have copier installed locally, use:\n\n```bash\ncopier copy --trust gh:DataChefHQ/Inception .\n```\n\n\n## Resources\n\n- [Devenv Docs](https://devenv.sh/getting-started/)\n- [Nix in 100 Seconds](https://www.youtube.com/watch?v=FJVFXsNzYZQ)\n\n## Contributing\n\nWe welcome contributions! Please check out our [contributing\nguidelines](CONTRIBUTING.md) to get started.\n\n## License\n\nThis project is licensed under the MIT License - see the\n[LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- Thanks to the open-source community for their invaluable\n  contributions to projects which we are building on:\n  - [Nix](https://nixos.org)\n  - [Devenv](https://devenv.sh)\n  - [Copier](https://copier.readthedocs.io/)\n- Inspiration and support from the DataChef team.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatachefhq%2Finception","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatachefhq%2Finception","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatachefhq%2Finception/lists"}