Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jowilf/qwikcrud
An AI-powered command-line tool that generates REST APIs and admin interfaces based on one line requirement
https://github.com/jowilf/qwikcrud
admin admin-dashboard ai chatgpt cli code-generation fastapi gemini gpt llm pydantic-v2 python3 restful-api sqlalchemy-file sqlalchemy2 starlette-admin
Last synced: 2 months ago
JSON representation
An AI-powered command-line tool that generates REST APIs and admin interfaces based on one line requirement
- Host: GitHub
- URL: https://github.com/jowilf/qwikcrud
- Owner: jowilf
- License: apache-2.0
- Created: 2023-11-28T23:32:25.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-18T22:02:15.000Z (about 1 year ago)
- Last Synced: 2024-10-18T23:10:53.497Z (3 months ago)
- Topics: admin, admin-dashboard, ai, chatgpt, cli, code-generation, fastapi, gemini, gpt, llm, pydantic-v2, python3, restful-api, sqlalchemy-file, sqlalchemy2, starlette-admin
- Language: Python
- Homepage: https://qwikcrud-demo.jowilf.com/
- Size: 64.5 KB
- Stars: 28
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# qwikcrud
[](https://pypi.org/project/qwikcrud)
[](https://pypi.org/project/qwikcrud)
-----
`qwikcrud` is a powerful command-line tool designed to enhance your backend development experience by automating the
generation of comprehensive REST APIs and admin interfaces. Say goodbye to the tedious task of
writing repetitive CRUD (Create, Read, Update, Delete) endpoints when starting a new project, allowing developers to
concentrate on the core business logic and functionality.
> [!WARNING]
> The generated application is not ready for production use. Additional steps are required to
> set up a secure and production-ready environment.
[](https://youtu.be/XYuLDk0bjQA "qwikcrud demo - A restaurant management app")
## Table of Contents
* [Installation](#installation)
* [Quickstart](#quickstart)
* [Environment variables](#environment-variables)
* [Usage](#usage)
* [Generated Application stack](#generated-application-stack)
* [Roadmap](#roadmap)
* [Contributing](#contributing)
* [Acknowledgments](#acknowledgments)
* [License](#license)
## Installation
```shell
pip install qwikcrud
```
## Quickstart
### Environment variables
Before running the command-line tool, ensure the following environment variables are configured:
#### Google
```shell
export GOOGLE_API_KEY="your_google_api_key"
```
#### OpenAI
```shell
export OPENAI_API_KEY="your_openai_api_key"
export OPENAI_MODEL="your_openai_model" # Defaults to "gpt-3.5-turbo-1106"
```
### Usage
To generate your application, open your terminal, run the following command and follow the instructions:
#### Google
```shell
qwikcrud -o output_dir
```
#### OpenAI
```shell
qwikcrud -o output_dir --ai openai
```
### Generated Application stack
- [FastAPI](https://fastapi.tiangolo.com/)
- [SQLAlchemy v2](https://www.sqlalchemy.org/)
- [Pydantic v2](https://docs.pydantic.dev/latest/)
- [Starlette-admin](https://github.com/jowilf/starlette-admin)
- [SQLAlchemy-file](https://github.com/jowilf/sqlalchemy-file)
### Examples
- Task
Management ([prompt](./examples/fastapi/task-management/prompt), [generated app](./examples/fastapi/task-management/generated))
## Roadmap
`qwikcrud` is designed to support various frameworks and AI providers. Here's an overview of what has been accomplished
and
what is planned for the future:
### Frameworks
- [x] FastAPI + SQLAlchemy
- [x] Restful APIs
- [x] Admin interfaces
- [ ] Authentication
- [ ] FastAPI + Beanie
- [ ] Spring Boot
### AI providers
- [x] Google (_default_)
- [x] OpenAI
- [ ] Anthropic
- [ ] Ollama (_self-hosted LLMs_)
## Pricing
`qwikcrud` makes one API call per prompt and add a system prompt of around 900 tokens to
your prompt.
- **Google**: Currently free.
- **OpenAI**: With the default gpt-3.5-turbo model, each app generation costs approximately $0.003. The exact cost can
vary slightly based on the model selected and the output length
## Contributing
Contributions are welcome and greatly appreciated! If you have ideas for improvements or encounter issues, please feel
free to submit a pull request or open an issue.
## Acknowledgments
- The FastAPI + SQLAlchemy template is inspired by the excellent work
in [full-stack-fastapi-postgresql](https://github.com/tiangolo/full-stack-fastapi-postgresql)
by [Sebastian Ramirez (tiangolo)].
## License
``qwikcrud`` is distributed under the terms of the [Apache-2.0](https://spdx.org/licenses/Apache-2.0.html) license.