{"id":23688010,"url":"https://github.com/lilyjge/ruth","last_synced_at":"2026-04-11T03:34:17.147Z","repository":{"id":269904519,"uuid":"908777398","full_name":"lilyjge/Ruth","owner":"lilyjge","description":"AI powered visual novel with dynamic dialogue and images","archived":false,"fork":false,"pushed_at":"2025-02-13T21:40:25.000Z","size":30925,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-22T03:38:04.885Z","etag":null,"topics":["diffusers","flask","groq-api","langchain","langgraph","llm","pinecone","rag","sqlite3","stable-diffusion"],"latest_commit_sha":null,"homepage":"https://e-d-e-n.itch.io/ruths-super-amazing-ai-adventure","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lilyjge.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2024-12-27T00:11:29.000Z","updated_at":"2025-02-13T21:40:29.000Z","dependencies_parsed_at":"2025-02-13T22:38:17.668Z","dependency_job_id":null,"html_url":"https://github.com/lilyjge/Ruth","commit_stats":null,"previous_names":["lilyjge/ruth"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lilyjge/Ruth","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lilyjge%2FRuth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lilyjge%2FRuth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lilyjge%2FRuth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lilyjge%2FRuth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lilyjge","download_url":"https://codeload.github.com/lilyjge/Ruth/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lilyjge%2FRuth/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31668049,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T17:19:37.612Z","status":"online","status_checked_at":"2026-04-11T02:00:05.776Z","response_time":54,"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":["diffusers","flask","groq-api","langchain","langgraph","llm","pinecone","rag","sqlite3","stable-diffusion"],"created_at":"2024-12-29T23:59:18.643Z","updated_at":"2026-04-11T03:34:17.125Z","avatar_url":"https://github.com/lilyjge.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ruth's Super Amazing AI Adventure!\n\nAI powered visual novel. Uses LangChain with Groq API's llama3-8b for LLM text generation, Huggingface's diffusers library with the Dark Sushi Mix checkpoint​ for image generation, Pinecone RAG for character memory, and SQLite database for saves. Music was made with Suno. Runs locally, that is, your computer hosts the Flask server and the game runs as a web application in your browser. \n\nDisclaimer: I'm not responsible for any of the AI generated content or the actions of any users.\n\n## Requirements\n\n- GPU for smooth gameplay\n- [Python](https://www.python.org/downloads/) (tested with version 3.12)\n- [Groq](https://console.groq.com/keys) API key (free tier available)\n- [Pinecone](https://www.pinecone.io/) API key (free tier available)\n- Flask secret key: random string, or you can generate one in terminal with python -c 'import secrets; print(secrets.token_hex())'\n\n## Installation\n\nOpen a terminal in the folder you want to install it in and enter the following commands:\n```\ngit clone https://github.com/lilyjge/Ruth.git\ncd Ruth\npython -m venv venv\n.\\venv\\Scripts\\activate \npip install -r requirements.txt\n```\n\nMake a file named .env in the Ruth folder to put your keys. It should look like this:\n```\nGROQ=...\nPINECONE=...\nFLASK=...\n```\nAlternatively, you can enter the keys in the terminal after running the program. You will only have to enter them once as they will be saved in a local database in the game directory. \n\nNext, run app.py with the following:\n```\npython app.py\n```\nWait for it to load and it should open a new window with the game.\n\nClosing the window or clicking the 'quit' button on the home page wille exit the game.\n\n## Configuration\n\nClick the settings button on the page to configure the quality of the art and the volume of the music.\n\n\n## Troubleshooting\n\nObserve the terminal output when app.py is ran. If the GPU is being used, \"cuda\" should be printed. If you have a GPU but CPU is printed instead, run the following:\n```\npip uninstall torch\n```\nThen go [here](https://pytorch.org/get-started/locally/) to install the appropriate version of PyTorch for your system. You only need torch, not torchvision nor torchaudio.\nFor an AMD GPU on Windows, you can follow this [example](https://github.com/microsoft/DirectML/blob/master/PyTorch/diffusion/sd/app.py) and modify a few lines in ```sd.py```.\n\nBe patient with it and don't click any buttons multiple times in a row. If a bug happens, close the program and start it again. Be warned the saving is not available until the introduction is done and when the ending begins.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flilyjge%2Fruth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flilyjge%2Fruth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flilyjge%2Fruth/lists"}