{"id":22488484,"url":"https://github.com/bennyschmidt/ragdoll-studio","last_synced_at":"2025-08-02T21:31:02.851Z","repository":{"id":227747372,"uuid":"772295891","full_name":"bennyschmidt/ragdoll-studio","owner":"bennyschmidt","description":"The creative suite for character-driven AI experiences.","archived":false,"fork":false,"pushed_at":"2024-05-16T17:28:09.000Z","size":5966,"stargazers_count":156,"open_issues_count":8,"forks_count":7,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-05-17T12:52:19.723Z","etag":null,"topics":["ai","ai-agents","ai-bots","ai-characters","ai-customer-service","ai-experts","ai-game-development","ai-npc","ai-support","ai-writing","ai-writing-assistant","chat-bots","customer-support","llm","llm-agents","llm-apps","rag-playground","retrieval-augmented-generation","scoped-knowledge","shopping-assistant"],"latest_commit_sha":null,"homepage":"https://ragdoll-studio.vercel.app","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/bennyschmidt.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-03-14T23:03:13.000Z","updated_at":"2024-05-16T17:33:45.000Z","dependencies_parsed_at":"2024-03-20T05:24:33.321Z","dependency_job_id":"5cc80f68-04d9-4567-bdc1-80410e91e705","html_url":"https://github.com/bennyschmidt/ragdoll-studio","commit_stats":null,"previous_names":["bennyschmidt/arthas.ai","bennyschmidt/ragdoll-studio"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bennyschmidt%2Fragdoll-studio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bennyschmidt%2Fragdoll-studio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bennyschmidt%2Fragdoll-studio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bennyschmidt%2Fragdoll-studio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bennyschmidt","download_url":"https://codeload.github.com/bennyschmidt/ragdoll-studio/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228500216,"owners_count":17930015,"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":["ai","ai-agents","ai-bots","ai-characters","ai-customer-service","ai-experts","ai-game-development","ai-npc","ai-support","ai-writing","ai-writing-assistant","chat-bots","customer-support","llm","llm-agents","llm-apps","rag-playground","retrieval-augmented-generation","scoped-knowledge","shopping-assistant"],"created_at":"2024-12-06T17:17:47.836Z","updated_at":"2024-12-06T17:20:15.328Z","avatar_url":"https://github.com/bennyschmidt.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Ragdoll Studio\n\nWeb apps and libraries for interacting with [Ragdoll](https://github.com/bennyschmidt/ragdoll).\n\n![product](https://github.com/bennyschmidt/ragdoll-studio/assets/45407493/84a5f7d3-9178-41bc-9bb4-265e4399a651)\n\n## Features\n\nGo beyond fine-tuning to produce flawless creative deliverables, rich multimedia, and engaging experiences.\n\n### 1. Story Mode\n\nCreate and chat with characters that have scoped knowledge and distinct personalities.\n\nDefine their source of knowledge at a URL (e.g. Wikipedia page).\n\n✨ ***Focus:** Upload additional documents to extend their knowledge.*\n\nhttps://github.com/bennyschmidt/ragdoll-studio/assets/45407493/cd7464fe-9984-4ae3-8911-1da104f68e8c\n\n\u003e The above video shows the case of a storyteller (Arthas Menethil, from *World of Warcraft*) who was created with limited knowledge, so he doesn't know as much as he should. This demonstration shows the ragdoll's knowledge being extended by uploading a text file containing additional information about his domain. After that, he knows and is able to talk about the new information and even renders images that are more on-brand. \n\n### 2. Picture Mode\n\nProduce images (photos, illustrations, concept art) in a specific style.\n\n✨ ***Inspire**: Upload source images to inspire compositional features of a new image.*\n\nhttps://github.com/bennyschmidt/ragdoll-studio/assets/45407493/20427f0b-7e64-449d-b9e2-d881f867dd5a\n\n\u003e The above video shows how Ragdoll uses Stable Diffusion's img2img feature through the lens of different ragdolls to produce a variety of different image results. Optionally check \"True to original\" to keep the overall structure of the source image in place while still applying stylistic attributes of the ragdoll. The initial `artStyle` set when creating a ragdoll defines the overall kind of image (photorealistic, concept art, pixel art, etc.) but because the ragdoll prompts `img2img` itself, some of its own speech patterns can influence the resulting image too.  \n \n### 3. Video Mode\n\nProduce videos (shows, podcasts, cinematics, cutscenes, films, animations) of a certain style or genre.\n\n✨ ***Stage**: Upload an image to set the stage for a new video clip.*\n\n*Coming soon!*\n\n### 4. Audio Mode\n\nProduce audio (music, sound effects, speech) of a certain style or genre.\n\n✨ ***Cue**: Upload an audio clip to cue a specific style or sound.*\n\n*Coming soon!*\n\n### 5. 3D Mode\n\nProduce 3D objects (scenes, characters, animations) in a specific style.\n\n✨ ***Inspire**: Upload source 3D objects to inspire compositional features of a new one.*\n\n*Coming soon!*\n\n### 6. Export \n\n✨ ***Download Content:** When you're happy with a result, download your generated content in a variety of formats, or clear the channel to start over.*\n\n![download](https://github.com/bennyschmidt/ragdoll-studio/assets/45407493/eea000cb-bd84-4dd6-b4a9-a463409a62f7)\n\n\u003e The above image shows the Download button highlighted in the bottom-right. The output format depends on which app mode you're currently in, see [#14](https://github.com/bennyschmidt/ragdoll-studio/issues/14).\n\n✨ ***Community Site:** Export \u0026 publish collections of ragdolls, or \"casts\", and download others.*\n\n![community-site](https://github.com/bennyschmidt/ragdoll-studio/assets/45407493/3dd6e058-957b-4947-a0d8-09c93152bc93)\n\n\u003e The above image shows casts of characters, or [dolls](https://ragdoll-studio.vercel.app/dolls), on the [community site](https://ragdoll-studio.vercel.app/). If you want to share characters you've created or download others, you can do so through sharing casts. There's also an [apps](https://ragdoll-studio.vercel.app/) section that's coming soon for the purpose of sharing different apps created with the Ragdoll software (using Ragdoll [core](https://github.com/bennyschmidt/ragdoll) and/or the [node](https://www.npmjs.com/package/ragdoll-api) or [react](https://www.npmjs.com/package/ragdoll-react) libraries).\n\n## Installation\n\n1. Configure the [API](https://github.com/bennyschmidt/ragdoll-studio/tree/master/ragdoll-api)\n\n`cd ragdoll-api`\n\nSee the API `README.md`.\n\n2. Install dependencies\n\n`nvm use \u0026\u0026 npm i`\n\n3. Start the server\n\n`npm start`\n\nYou should see something like this:\n\n```\nA worker has spawned.\nA worker has spawned.\nA worker has spawned.\nA worker has spawned.\nA worker has spawned.\nA worker has spawned.\nA worker has spawned.\nA worker has spawned.\nCluster is online at http://localhost:8000\nWorker online (#1).\nWorker online (#2).\nWorker online (#3).\nWorker online (#4).\nWorker online (#5).\nWorker (#1) is listening for messages.\nWorker (#3) is listening for messages.\nWorker (#2) is listening for messages.\nWorker (#5) is listening for messages.\nWorker online (#6).\nWorker online (#8).\nWorker (#4) is listening for messages.\nWorker online (#7).\nWorker (#6) is listening for messages.\nWorker (#8) is listening for messages.\nWorker (#7) is listening for messages.\n```\n\nThis means the server is running and handling concurrent requests on all CPU cores. \n\nRagdoll API is now listening on `http://localhost:8000/`.\n\n4. Set up the [front-end](https://github.com/bennyschmidt/ragdoll-studio/tree/master/ragdoll-react)\n\n`cd ../ragdoll-react`\n\nSee the React `README.md`.\n\n`nvm use \u0026\u0026 npm i`\n\n5. Start the front-end\n\n`npm start`\n\nYou should see the default UI:\n\n![Ragdoll UI](https://github.com/bennyschmidt/ragdoll-studio/assets/45407493/4113aa84-83e8-4807-b651-a57090c3c587)\n\n-----\n\n## Usage\n\n#### Ragdoll app\n\n[How to use the app](https://github.com/bennyschmidt/ragdoll-studio/blob/master/ragdoll-react/README.md)\n\n#### Ragdoll API\n\n[How to run the API](https://github.com/bennyschmidt/ragdoll-studio/blob/master/ragdoll-api/README.md)\n\n-----\n\n## Use Cases\n\nSee [CaseStudies.md](./CaseStudies.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbennyschmidt%2Fragdoll-studio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbennyschmidt%2Fragdoll-studio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbennyschmidt%2Fragdoll-studio/lists"}