{"id":22619877,"url":"https://github.com/akshatvg/narrative","last_synced_at":"2025-04-15T22:37:55.656Z","repository":{"id":111809681,"uuid":"347553816","full_name":"akshatvg/Narrative","owner":"akshatvg","description":"With Narrative, anyone can express themself creatively and make exciting comics in minutes through voice based commands and a simple UI.","archived":false,"fork":false,"pushed_at":"2021-03-20T03:16:31.000Z","size":2078,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-15T22:37:52.588Z","etag":null,"topics":["comic","generator","hacklikeagirl","narrative","voice"],"latest_commit_sha":null,"homepage":"https://narrative.akshatvg.com","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/akshatvg.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":"2021-03-14T05:39:42.000Z","updated_at":"2021-04-30T19:23:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"7220454d-680f-42bc-ac68-eb884d5b5319","html_url":"https://github.com/akshatvg/Narrative","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":"akshatvg/template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akshatvg%2FNarrative","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akshatvg%2FNarrative/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akshatvg%2FNarrative/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akshatvg%2FNarrative/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/akshatvg","download_url":"https://codeload.github.com/akshatvg/Narrative/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249167410,"owners_count":21223503,"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":["comic","generator","hacklikeagirl","narrative","voice"],"created_at":"2024-12-08T22:09:43.802Z","updated_at":"2025-04-15T22:37:55.649Z","avatar_url":"https://github.com/akshatvg.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Narrative\n\n[![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/akshatvg/Narrative?logo=github\u0026style=social)](https://github.com/akshatvg/) [![GitHub last commit](https://img.shields.io/github/last-commit/akshatvg/Narrative?style=social\u0026logo=git)](https://github.com/akshatvg/) [![GitHub stars](https://img.shields.io/github/stars/akshatvg/Narrative?style=social)](https://github.com/akshatvg/Narrative/stargazers) [![GitHub forks](https://img.shields.io/github/forks/akshatvg/Narrative?style=social\u0026logo=git)](https://github.com/akshatvg/Narrative/network)\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://narrative.akshatvg.com\"\u003e\n\u003cimg src=\"assets/img/border-logo.png\" width=\"400px\" alt=\"Narrative Logo\"/\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\n![Generic badge](https://img.shields.io/badge/Narrative-Modernising_Comics-orange) \n\n#### Link for [demo](https://narrative.akshatvg.com) \n[![Generic badge](https://img.shields.io/badge/view-video-orange)](https://www.youtube.com/watch?v=AHKhUQFZMb8m)\n\n## Introduction\nRemember when reading the newest edition of Tintin or Archies or Tinkle was the highlight of your day? With the writing and publishing trends of comics going down, we are here to save the day with a technological twist.\n\nWith **Narrative**, anyone can express themself creatively and make exciting comics in minutes through voice based commands and a simple UI.\n\n## About Narrative\nNarrative is a web app where the user can speak/ type a story which will get converted into relevant comic style images where you can also add narrative text boxes and character speech bubbles.\n\n## Features\n- Speech to Text\n- Text to Image\n- Cartoonification\n- Real time generation\n- Eliminates need to know how to draw\n- Share on Twitter\n- Share on WhatsApp\n- Simple UI\n- Help mode\n\n\n## Applications\n- Artists who relied on drawing and drafting all their content themselves have been suffering huge financial losses since they haven't been able to adapt to the digital trends. This means lesser number of copies sold and wastage of paper. Through our technological twist, the same non-tech-savvy artists will be able to make digital comics.\n- Creative youth like us who have ideas but are too lazy to write and pen down their ideas will be able to express themselves better.\n- Utilisation of time during COVID- an idle mind is the devil's playground.\n\n\n## Marketing and business model\n- We intend to keep the product free for at least a year to ensure we get the marketing we deserve- happy and long lasting user retention is our goal.\n- We will charge minor subscription fees after a month's free trial (Freemium model) to keep the servers running.\n- Major source of our revenue will be by running advertisements on our site.\n\n## How it works\n1. JavaScript Web Speech API for audio transcription (default with HTML5)\n2. The transcribed or written text is searched for relevant images using the Custom Search API in GCP and an image is returned to user which can be used as the comic background\n3. Since we get human like images, we cartoonify the images using OpenCV\n4. The core functionalities like adding bubbles or text-boxes or headings or sharing are done through Vanilla JS and jQuery.\n\n## Tech Stack\n- **Front-end:** HTML, CSS, JavaScript, jQuery\n- **Back-end:** Django with PostgreSQL\n- **Design and PPT:** AdobeXD\n- **Deployment:** Heroku and Netlify\n- **Image API**: *Custom Search API* on Google Cloud Platform and *Custom Search Engine* on [cse.google.com/cse/all](https://cse.google.com/cse/all)\n- **Cartoonification:** OpenCV\n\n## Requirements\nThe source code of this project is written in **`HTML/CSS/JS`**. So, you do not require anything extra to run this project.\n\n## Instructions to run front-end\n\n[![chrome](https://img.shields.io/badge/Open-index.html-lightgrey.svg?logo=google-chrome\u0026style=popout\u0026logoColor=red)](https://narrative.akshatvg.com)\n\nExtract the folder and run `index.html`\n\n## Instructions to run back-end\n```bash\n$ git clone https://github.com/akshatvg/Narrative\n$ cd Narrative\n$ pip3 install -r requirements.txt\n$ python3 manage.py runserver\n```\n\n## Contributors\n- [Akshat Gupta](https://github.com/akshatvg)\n- [Sai Sandeep](https://github.com/raysandeep)\n- [Muskan Tewari](https://github.com/muskantewari)\n- [Nishi Jain](https://github.com/nishijjain)\n\n\n## Need help?\n\n\nFeel free to contact me via [Facebook](https://www.facebook.com/akshatvg).\n\nInvite me to connect on [LinkedIn](https://www.linkedin.com/in/akshatvg/).\n\n[![Facebook](https://img.shields.io/badge/Facebook-add-blue.svg?logo=facebook\u0026logoColor=white)](https://www.facebook.com/akshatvg) [![Quora](https://img.shields.io/badge/Quora-ask-red.svg?logo=quora)](https://www.quora.com/profile/Akshat-Gupta-279) [![Instagram](https://img.shields.io/badge/Instagram-follow-purple.svg?logo=instagram\u0026logoColor=white)](https://www.instagram.com/akshatvg/) [![Snapchat](https://img.shields.io/badge/Snapchat-add-yellow.svg?logo=snapchat\u0026logoColor=white)](https://www.snapchat.com/add/akshatvg) [![Medium](https://img.shields.io/badge/Medium-follow-black.svg?logo=medium\u0026logoColor=white)](https://medium.com/@akshatvg)\n\n\n```bash\n\n\n\n _____ _                 _     __   __            \n|_   _| |               | |    \\ \\ / /            \n  | | | |__   __ _ _ __ | | __  \\ V /___  _   _   \n  | | | '_ \\ / _` | '_ \\| |/ /   \\ // _ \\| | | |  \n  | | | | | | (_| | | | |   \u003c    | | (_) | |_| |  \n  \\_/ |_| |_|\\__,_|_| |_|_|\\_\\   \\_/\\___/ \\__,_|  \n                                                  \n                                                  \n______                                            \n|  ___|                                           \n| |_ ___  _ __                                    \n|  _/ _ \\| '__|                                   \n| || (_) | |                                      \n\\_| \\___/|_|                                      \n                                                  \n                                                  \n______      _               _   _               _ \n| ___ \\    (_)             | | | |             | |\n| |_/ / ___ _ _ __   __ _  | |_| | ___ _ __ ___| |\n| ___ \\/ _ \\ | '_ \\ / _` | |  _  |/ _ \\ '__/ _ \\ |\n| |_/ /  __/ | | | | (_| | | | | |  __/ | |  __/_|\n\\____/ \\___|_|_| |_|\\__, | \\_| |_/\\___|_|  \\___(_)\n                     __/ |                        \n                    |___/                         \n\n \n\n\n```\n\n## License\n\n**MIT \u0026copy; [Akshat Gupta](https://github.com/akshatvg/Narrative/blob/master/LICENSE)**\n\n[![GitHub license](https://img.shields.io/github/license/akshatvg/Narrative?style=social\u0026logo=github)](https://github.com/akshatvg/Narrative/blob/master/LICENSE) [![Twitter Follow](https://img.shields.io/twitter/follow/akshatvg?style=social)](https://twitter.com/akshatvg)\n\n---------\n\n```javascript\n\nif (youEnjoyed) {\n    starThisRepository();\n}\n\n```\n\n-----------\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakshatvg%2Fnarrative","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakshatvg%2Fnarrative","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakshatvg%2Fnarrative/lists"}