{"id":22907374,"url":"https://github.com/forgineer/flask-sqlitecloud-example","last_synced_at":"2026-04-20T19:03:11.322Z","repository":{"id":265622179,"uuid":"896223330","full_name":"forgineer/flask-sqlitecloud-example","owner":"forgineer","description":"An example Flask app with sqlitecloud.io Integration (using SQLAlchemy)","archived":false,"fork":false,"pushed_at":"2024-11-30T20:11:51.000Z","size":46,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-01T09:08:18.326Z","etag":null,"topics":["bootstrap5","flask","flask-sqlalchemy","htmx","sqlite3-database","sqlitecloud"],"latest_commit_sha":null,"homepage":"","language":"HTML","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/forgineer.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}},"created_at":"2024-11-29T20:15:54.000Z","updated_at":"2024-11-30T20:11:54.000Z","dependencies_parsed_at":"2024-11-30T07:27:37.519Z","dependency_job_id":"8f14c5c6-1a21-4e99-bc92-a122c04d1d0c","html_url":"https://github.com/forgineer/flask-sqlitecloud-example","commit_stats":null,"previous_names":["forgineer/flask-sqlitecloud-example"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/forgineer/flask-sqlitecloud-example","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forgineer%2Fflask-sqlitecloud-example","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forgineer%2Fflask-sqlitecloud-example/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forgineer%2Fflask-sqlitecloud-example/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forgineer%2Fflask-sqlitecloud-example/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/forgineer","download_url":"https://codeload.github.com/forgineer/flask-sqlitecloud-example/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forgineer%2Fflask-sqlitecloud-example/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269649848,"owners_count":24453541,"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-08-09T02:00:10.424Z","response_time":111,"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":["bootstrap5","flask","flask-sqlalchemy","htmx","sqlite3-database","sqlitecloud"],"created_at":"2024-12-14T03:14:45.574Z","updated_at":"2026-04-20T19:03:06.302Z","avatar_url":"https://github.com/forgineer.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# flask-sqlitecloud-example\nThis project is an example Flask app that uses [sqlitecloud.io](https://sqlitecloud.io/), a distributed relational database system built on top of the SQLite database engine. This project was created to learn more about that platform and provide an additional example of using their Python client SDK with Flask and SQLAlchemy. This project also implements [Bootstrap](https://getbootstrap.com/) and [HTMX](https://htmx.org/) for a simple and clean UI/UX.\n\nThe app is a simple task list. Tasks can be written and submitted by the user to update their list of todos. Tasks can also be deleted from the list as needed.\n\n![Task List App](images/app.png)\n\nThese actions are reflected in the SQLite database and can be viewed from the SQLite Cloud online studio.\n\n![SQLiteCloud Studio View](images/sqlitecloud-studio.png)\n\n---\n\n## Setup and Execution Instructions\n\nFollow these steps to set up and run this example on your local machine. This guide assumes you have Git and Python (3.10 or above) installed on your system.\n\n### 1. Create a Free account with SQLite Cloud\n\nAt the time of writing this, [sqlitecloud.io](https://sqlitecloud.io/) has a free tier where users can have an account with 1GB of free storage space on the platform. Create your account and step through the process of creating a project, node, and a database. This guide does not include those steps in-depth, but it should be pretty straightforward with its easy-to-use UI. After doing this, SQLite Cloud should be able to generate an API connection string for your created database like the example below:\n\n```commandline\nsqlitecloud://MyNode.sqlite.cloud:8860/task_list?apikey=ThisIsAFakeAPIKeyForDemonstrationPurposes\n```\n\n### 2. Clone the Repository\n\nNext, clone this repository from GitHub to your local machine:\n\n```bash\ngit clone https://github.com/forgineer/flask-sqlitecloud-example.git\n```\n\n### 3. Navigate to the Project Directory\n\nFrom the terminal navigate to the newly cloned project `flask-sqlitecloud-example` directory:\n\n```bash\ncd flask-sqlitecloud-example\n```\n\n### 4. Create and Activate a Python Virtual Environment\n\nCreate a virtual environment in the project directory. This isolates the project dependencies from your global Python environment and is considered good practice.\n\nTo create a virtual environment, run:\n\n```bash\npython -m venv venv\n```\n\nActivate the virtual environment:\n\n- On Windows, use:\n\n  ```bash\n  .\\venv\\Scripts\\activate\n  ```\n\n- On Unix or MacOS, use:\n\n  ```bash\n  source venv/bin/activate\n  ```\n\n### 5. Install the Application Dependencies\n\nWith the virtual environment activated, install its core dependencies using pip:\n\n```bash\npip install flask flask-sqlalchemy requests sqlalchemy sqlalchemy-sqlitecloud sqlitecloud\n```\n\nUsing the latest Python and package versions is expected to work. However, if conflicts do arise, this example was originally written using Python 3.10 and should be repeatable with the list of original package versions listed in the `dev_requirements.txt` file if needed.\n\n```bash\npip install -r dev_requirements.txt\n```\n\n### 6. Create a Config File Module\n\nCreate a configuration file containing the connection string from step one above. This should be written as a Python module `config.py` with a variable named `SQLALCHEMY_DATABASE_URI` set to the value of the connection string. When the application runs, it will read this configuration automatically and enable connectivity between the app and your SQLite Cloud database.\n\n```python\n# config.py\nSQLALCHEMY_DATABASE_URI='sqlitecloud://MyNode.sqlite.cloud:8860/task_list?apikey=ThisIsAFakeAPIKeyForDemonstrationPurposes'\n```\n\n\u003e :warning: If you decide to fork, copy, and/or build onto this example for your purposes, please ensure that you \u003cu\u003eexclude\u003c/u\u003e this file from your repository from within your `.gitignore` file.\n\n### 7. Run the Application\n\nStart the application with Flask’s development server. Since the application is mostly self-contained within the `app.py` module, the default run command can be used:\n\n```bash\nflask run\n```\n\n### 8. Access the Application\n\nOnce the application is running, open your web browser and navigate to:\n\n```\nhttp://localhost:5000\n```\n\nI hope this example is/was helpful to you!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforgineer%2Fflask-sqlitecloud-example","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fforgineer%2Fflask-sqlitecloud-example","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforgineer%2Fflask-sqlitecloud-example/lists"}