{"id":14970845,"url":"https://github.com/ais-one/favv","last_synced_at":"2025-10-09T13:35:52.388Z","repository":{"id":44879633,"uuid":"345866952","full_name":"ais-one/favv","owner":"ais-one","description":"Fullstack Web Application Framework With FastAPI + Vite + VueJS. Streamlit for rapid development.","archived":false,"fork":false,"pushed_at":"2023-07-12T12:44:30.000Z","size":476,"stargazers_count":42,"open_issues_count":0,"forks_count":9,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-22T22:30:30.960Z","etag":null,"topics":["antd","boto3","fastapi","hacktoberfest","rest","sqlalchemy","streamlit","vite","vue"],"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/ais-one.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2021-03-09T03:07:23.000Z","updated_at":"2025-08-27T12:26:33.000Z","dependencies_parsed_at":"2025-02-11T17:47:58.712Z","dependency_job_id":null,"html_url":"https://github.com/ais-one/favv","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/ais-one/favv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ais-one%2Ffavv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ais-one%2Ffavv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ais-one%2Ffavv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ais-one%2Ffavv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ais-one","download_url":"https://codeload.github.com/ais-one/favv/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ais-one%2Ffavv/sbom","scorecard":{"id":173793,"data":{"date":"2025-08-11","repo":{"name":"github.com/ais-one/favv","commit":"616be8d3704776e1e926d286f1d6e6e4ef17e6fd"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.5,"checks":[{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":0,"reason":"Found 0/6 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/publish-to-pypi.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish-to-pypi.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/ais-one/favv/publish-to-pypi.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish-to-pypi.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/ais-one/favv/publish-to-pypi.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish-to-pypi.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/ais-one/favv/publish-to-pypi.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish-to-pypi.yml:50: update your workflow using https://app.stepsecurity.io/secureworkflow/ais-one/favv/publish-to-pypi.yml/master?enable=pin","Warn: containerImage not pinned by hash: fastapi/Dockerfile.example:1: pin your Docker image by updating python:3.8 to python:3.8@sha256:d411270700143fa2683cc8264d9fa5d3279fd3b6afff62ae81ea2f9d070e390c","Warn: containerImage not pinned by hash: streamlit/Dockerfile.example:1: pin your Docker image by updating python:3.8 to python:3.8@sha256:d411270700143fa2683cc8264d9fa5d3279fd3b6afff62ae81ea2f9d070e390c","Warn: pipCommand not pinned by hash: fastapi/Dockerfile.example:13","Warn: pipCommand not pinned by hash: fastapi/Dockerfile.example:14","Warn: pipCommand not pinned by hash: streamlit/Dockerfile.example:12","Warn: pipCommand not pinned by hash: streamlit/Dockerfile.example:13","Warn: pipCommand not pinned by hash: fastapi/app/custom_app/install.sh:25","Warn: pipCommand not pinned by hash: fastapi/app/custom_app/install.sh:34","Warn: pipCommand not pinned by hash: fastapi/app/custom_app/install.sh:38","Warn: pipCommand not pinned by hash: fastapi/install.sh:24","Warn: pipCommand not pinned by hash: fastapi/install.sh:33","Warn: pipCommand not pinned by hash: fastapi/install.sh:35","Warn: npmCommand not pinned by hash: .github/workflows/publish-to-pypi.yml:29","Info:   0 out of   3 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   1 third-party GitHubAction dependencies pinned","Info:   0 out of   1 npmCommand dependencies pinned","Info:   0 out of   2 containerImage dependencies pinned","Info:   0 out of  10 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 29 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"39 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-6p56-wp2h-9hxr","Warn: Project is vulnerable to: GHSA-fpfv-jqm9-f5jm","Warn: Project is vulnerable to: PYSEC-2024-230 / GHSA-248v-346w-9cwc","Warn: Project is vulnerable to: PYSEC-2022-42986 / GHSA-43fp-rhv2-5gv8","Warn: Project is vulnerable to: PYSEC-2023-135 / GHSA-xqr8-7jwr-rhp7","Warn: Project is vulnerable to: GHSA-3ww4-gg4f-jr7f","Warn: Project is vulnerable to: GHSA-5cpq-8wj7-hf2v","Warn: Project is vulnerable to: GHSA-9v9h-cgj8-h64p","Warn: Project is vulnerable to: PYSEC-2023-254 / GHSA-jfhm-5ghh-2f97","Warn: Project is vulnerable to: GHSA-jm77-qphf-c4w8","Warn: Project is vulnerable to: GHSA-v8gr-m533-ghj9","Warn: Project is vulnerable to: GHSA-w7pp-m8wf-vj6r","Warn: Project is vulnerable to: GHSA-x4qr-2fvf-3mr5","Warn: Project is vulnerable to: GHSA-wj6h-64fc-37mp","Warn: Project is vulnerable to: PYSEC-2021-100 / GHSA-8h2j-cgx8-6xv7","Warn: Project is vulnerable to: PYSEC-2024-38 / GHSA-2jv5-9r88-3w3p","Warn: Project is vulnerable to: GHSA-vqfr-h8mv-ghfj","Warn: Project is vulnerable to: PYSEC-2024-60 / GHSA-jjg7-2v4v-x38h","Warn: Project is vulnerable to: GHSA-55x5-fj6c-h6m8","Warn: Project is vulnerable to: PYSEC-2022-230 / GHSA-wrxv-2j5q-m38w","Warn: Project is vulnerable to: PYSEC-2021-47 / GHSA-5jqp-qgf6-3pvh","Warn: Project is vulnerable to: GHSA-mr82-8j83-vxmv","Warn: Project is vulnerable to: GHSA-m87m-mmvp-v9qm","Warn: Project is vulnerable to: PYSEC-2024-232 / GHSA-6c5p-j8vq-pqhj","Warn: Project is vulnerable to: PYSEC-2024-233 / GHSA-cjwg-qfpm-7377","Warn: Project is vulnerable to: GHSA-59g5-xgcq-4qw3","Warn: Project is vulnerable to: GHSA-9hjg-9r4m-mvj7","Warn: Project is vulnerable to: GHSA-9wx4-h78v-vm56","Warn: Project is vulnerable to: PYSEC-2023-74 / GHSA-j8r2-6x86-q33q","Warn: Project is vulnerable to: GHSA-2c2j-9gv5-cj73","Warn: Project is vulnerable to: PYSEC-2023-48 / GHSA-74m5-2c7w-9w3x","Warn: Project is vulnerable to: GHSA-f96h-pmfr-66vw","Warn: Project is vulnerable to: PYSEC-2023-83 / GHSA-v5gw-mw7f-84px","Warn: Project is vulnerable to: GHSA-34jh-p97f-mpxf","Warn: Project is vulnerable to: PYSEC-2023-212 / GHSA-g4mx-q9vg-27p4","Warn: Project is vulnerable to: GHSA-pq67-6m6q-mj2v","Warn: Project is vulnerable to: PYSEC-2021-108 / GHSA-q2q7-5pp4-w6pg","Warn: Project is vulnerable to: PYSEC-2023-192 / GHSA-v845-jxx5-vc9f","Warn: Project is vulnerable to: PYSEC-2021-95 / GHSA-8ch4-58qp-g3mp"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-16T17:12:45.481Z","repository_id":44879633,"created_at":"2025-08-16T17:12:45.481Z","updated_at":"2025-08-16T17:12:45.481Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001479,"owners_count":26083102,"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","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["antd","boto3","fastapi","hacktoberfest","rest","sqlalchemy","streamlit","vite","vue"],"created_at":"2024-09-24T13:44:13.955Z","updated_at":"2025-10-09T13:35:52.356Z","avatar_url":"https://github.com/ais-one.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# About FAVV (FastAPI+ViteVue)\n\nFastAPI Python backend (BE) and Vite + VueJS + Ant Design frontend (FE) template... for your API and Web application needs.\n\nThe difference between this project and [https://github.com/ais-one/cookbook](https://github.com/ais-one/cookbook) is described [here](https://github.com/ais-one/cookbook/blob/master/README.md#about)\n\nAlso includes some samples in streamlit\n\n## Considerations\n\nThe following are considerations for the project. The aim is to allow things to be built faster and reduce maintenence overhead.\n\n- code reusability\n- application segregation **inject your own frontend and backend project**\n- ease of template upgrade\n- ci/cd and container friendly\n- microservices friendly\n- up to date dependencies\n- reducing technical debt\n- scalability\n\n## Roadmap \u0026 Updates\n\nSee [CHANGELOG.md](./CHANGELOG.md)\n\n## Development - Setup and Run\n\n### Backend\n\n\u003e python: 3.8.5, pip: 20.1.1\n\n```bash\ncd fastapi\n\n# create environment called dev\npython -m venv dev # python3 -m venv /path/to/new/virtual/env\n\n# copy .env.example to .env, adjust your own custom env settings here\ncp ./app/.env.example ./app/.env # common environment\ncp ./app/.env.local.example ./app/.env.local # for local machine deployment\ncp ./app/.env.docker-compose.example ./app/.env.docker-compose # for docker compose deployment\n\n# copy requirements.txt.example to copy requirements.txt (point to your own custom requirements.txt inside)\ncp ./requirements.txt.example ./requirements.txt\n```\n### activate env in windows\n\n```\n# cmd \ndev\\Scripts\\activate\ndev\\Scripts\\deactivate\n\n# powershell\ndev\\Scripts\\Activate.ps1\ndeactivate\n```\n### activate env in linux\n\n```\nsource dev/bin/activate \n```\n\n# Installing / Upgrading python packages\n\n## For framework\n\nrun **fastapi/install.sh**\n\n## For your own applications\n\nManage packages using **fastapi/app/\u003ccustom_app\u003e/requirements.txt**\n\nOr run **fastapi/app/\u003ccustom_app\u003e/install.sh**\n\n\n# Run App \u0026 Task Quque (requires redis)\n\n```bash\ncd app\n\n# fastapi application\npython main.py # OPTION 1 - running using python\nuvicorn main:app --reload --host=0.0.0.0 --port=3000 --access-log --log-level=debug --header server:none # OPTION 2 - running uvicorn\n\n# HTTPS\n# if using SSL include the following to uvicorn, also set USE_HTTPS in environment file\n# --ssl-keyfile \u003cpath\u003e - SSL key file --ssl-certfile \u003cpath\u003e - SSL certificate file\n\n# huey task queue consumer \nhuey_consumer custom_app.models.tasks.huey\n\n```\n\nNavigate to - http://127.0.0.1:3000/api-docs\n\n**Note:** if you use https and self-signed cert you may need to allow on browser\n\n## HTTPS\n\nGenerate your private key and...\n\nCreate a self-signed cert, or get a signed cert\n\n```bash\nopenssl req -x509 -newkey rsa:4096 -keyout local.key.pem -out local.cert.pem -days 365 -nodes -subj '/CN=127.0.0.1'\n```\n\n## Production Run (Docker)\n\n```bash\ncd ../fastapi\ndocker build -t \u003cyour-image-name\u003e:\u003ctag\u003e .\ndocker run -it \u003cyour-image-name\u003e:\u003ctag\u003e\n```\n\n### Frontend\n\n- VueJS 3\n- Vite 2 [https://github.com/vuejs/vite](https://github.com/vuejs/vite)\n- Ant Design 2\n\nrefer to [vitevue/README.md](vitevue/README.md)\n\n### Streamlit\n\nSee [streamlit/README.md](streamlit/README.md) for more information\n\n---\n\n\n# Customization\n\n## Structure - Files / Folders For Customisation Or Use\n\n```md\n+ favv\n  + fastapi/\n  | + app/\n  | | + .env: backend config\n  | | + \u003cyour-custom-backend\u003e_app/: folder with suffix \"_app\" are your custom backend code, models, uploads (your backend repo)\n  | |   + .gitignore: for your repo\n  | |   + base.py: this file name is required, and an FastApi ApiRouter of the name router_\u003cyour-custom-backend\u003e_app is needed\n  | |   + requirments.txt: your dependencies\n  | |   + models/ \n  | |     * tasks.py: custom task queue file\n  | |   + uploads/\n  | + .env: environment state, custom app name and version\n  | + .env.\u003cyour-environment\u003e: environment specific info\n  | + Dockerfile.example: DO NOT TOUCH THIS, use this as an example for your own Dockerfile\n  | + install.sh: DO NOT TOUCH THIS \n  | + requirements.base.txt: DO NOT TOUCH THIS\n  + streamlit/\n  | + app/ : demo application\n  | + component-template/ : streamlit custom components\n  |   + streamlit-antv: using antv charts on streamlit\n  |   + streamlit-vite: basic example of using vite to build streamlit-components\n  |   + streamlit-xui: extended UI components for streamlit\n  + vitevue/\n    + README.md\n```\n\n**NOTES**\n- All folders and files prefixed with TBD can be ignored, they are not implemented and used for reference\n\n## Backend Customization Notes\n\nSetting up your custom backend\n\n```bash\n# in favv/fastapi/app/\n# note that project name must end with suffix \"_app\"\ngit clone \u003cyour backend project e.g. example_app\u003e\n```\n\n- use **favv/fastapi/app/custom_app/** as reference on your custom backend\n  - on working with your custom endpoints, using db, s3, file services\n  - working with files in **favv/fastapi/app/custom_app/uploads/** folder\n  - running subprocess in **favv/fastapi/app/custom_app/models/** folder\n- set the APP, to the folder name of your custom app in **favv/fastapi/app/.env**\n  - specify the VERSION and the ENVIRONMENT state (local, docker-compose, production, \u003cyour-environment-name\u003e etc...)\n  - specify APP which is your custom application, UPLOAD_FOLDER and MODEL_FOLDER is directly inside your custom app folder\n  - set uour environment specific information in **favv/fastapi/app/.env.\u003cyour-environment-name\u003e**\n- application path is **favv/fastapi/app/** as **main.py** is run from there (either using python or uvicorn)\n- test endpoints in **favv/fastapi/app/api/routes/test.py** will not be available in production environment\n- NOTE: update **favv/fastapi/app/config.py** when **.env** entries change\n- NOTE: any code outside **favv/fastapi/app** will not auto reload\n\n## Notes\n\n- use **fastapi/install.sh** to update python libraries\n- for favv/fastapi .env host is **redis** if using docker compose **127.0.0.1** otherwise\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fais-one%2Ffavv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fais-one%2Ffavv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fais-one%2Ffavv/lists"}