{"id":13643668,"url":"https://github.com/josephrocca/opencharacters","last_synced_at":"2025-04-21T02:31:01.851Z","repository":{"id":124914121,"uuid":"610229529","full_name":"josephrocca/OpenCharacters","owner":"josephrocca","description":"Simple little web interface for creating characters and chatting with them. It's basically a single HTML file - no server. Share characters using a link (character data is stored within the URL itself). All chat data is stored in your browser using IndexedDB. Currently supports OpenAI APIs and ~any Hugging Face model.","archived":false,"fork":false,"pushed_at":"2025-03-29T22:09:15.000Z","size":3051,"stargazers_count":392,"open_issues_count":27,"forks_count":68,"subscribers_count":15,"default_branch":"main","last_synced_at":"2025-04-19T20:38:49.405Z","etag":null,"topics":["chatbot","chatgpt","openai"],"latest_commit_sha":null,"homepage":"https://josephrocca.github.io/OpenCharacters","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/josephrocca.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":"2023-03-06T11:03:26.000Z","updated_at":"2025-04-15T12:07:35.000Z","dependencies_parsed_at":"2023-11-16T14:37:54.901Z","dependency_job_id":"90334b31-c9b2-4e63-8d00-9b613b1770ab","html_url":"https://github.com/josephrocca/OpenCharacters","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josephrocca%2FOpenCharacters","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josephrocca%2FOpenCharacters/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josephrocca%2FOpenCharacters/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josephrocca%2FOpenCharacters/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/josephrocca","download_url":"https://codeload.github.com/josephrocca/OpenCharacters/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249986047,"owners_count":21356314,"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":["chatbot","chatgpt","openai"],"created_at":"2024-08-02T01:01:51.045Z","updated_at":"2025-04-21T02:30:56.842Z","avatar_url":"https://github.com/josephrocca.png","language":"HTML","funding_links":[],"categories":["Browser-extensions"],"sub_categories":[],"readme":"(**Note**: This repo is in maintenance mode at the moment - bug fixes and small updates only. If you're working on adding substantial new features via a fork, please open an issue with a link and I'll put it here. Note that the system is very extensible via your character's [custom code](https://github.com/josephrocca/OpenCharacters/blob/main/docs/custom-code.md), so you should see if it's possible to achieve the feature that you want via that.)\n\n![banner](https://user-images.githubusercontent.com/1167575/225629372-eb4de08a-ed62-4660-a83d-6e42a5c092d7.jpg)\n\n\n\u003cp align=\"center\"\u003eSimilar to CharacterAI, but open source, and with much deeper character customization.\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003cb\u003e⟶ \u003ca href=\"https://josephrocca.github.io/OpenCharacters\"\u003eTry it!\u003c/a\u003e ⟵\u003c/b\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://discord.gg/5tkWXJFqPV\"\u003eDiscord Server\u003c/a\u003e\u003c/p\u003e\n\n## Features:\n* The whole web app is a single HTML file - no server (serve it [locally](https://github.com/josephrocca/OpenCharacters/blob/main/docs/local-setup.md) if you want).\n* All your data is stored in your browser's local storage (again, there is no server).\n* Share characters with a link - all character data is embedded within the link.\n* Auto-summarization algorithm (for old messages) which extends effective character memory/context size massively.\n* Characters automatically compress messages into 'memories' and retrieve relevant memories based on context. Can handle as many memories as you need - tens of thousands or more.\n* Add lorebook(s) to your character, and add thread-specific lore with the `/lore` command.\n* Fully extensible with [custom code](https://github.com/josephrocca/OpenCharacters/blob/main/docs/custom-code.md). See examples [here](https://github.com/josephrocca/OpenCharacters/blob/main/docs/custom-code-examples.md).\n  * Give your character access to the internet\n  * Create your own slash commands\n  * Give your character a video avatar (custom code has its own iframe \u0026 can display arbitrary content)\n  * Create a \"game master\" [with a separate AI-powered process](https://tinyurl.com/5t3x8pdk) that tracks your abilities, inventory, etc.\n  * Create your own memory structures (embedding, retrieval, etc.)\n  * Give your character an internal thought process that runs alongside the chat\n  * Give your character a voice via the browser's built-in TTS, or via an external API like ElevenLabs\n  * Characters can [edit their own personality and custom code](https://tinyurl.com/4ccnn9zb) - self-improving and change over time\n  * Allow your character to execute [Python](https://github.com/josephrocca/OpenCharacters/blob/main/docs/running-python-code.md) or JavaScript code.\n* Currently supports OpenAI APIs [and most Hugging Face models](https://github.com/josephrocca/OpenCharacters/blob/main/docs/custom-models.md).\n* Easily import character files and conversation data most other formats.\n* Send new feature ideas or bug reports [here](https://github.com/josephrocca/OpenCharacters/issues) or on our [Discord server](https://discord.gg/5tkWXJFqPV).\n\n## Changelog\n\nPlease see the `#announcements` channel on the [Discord server](https://discord.gg/5tkWXJFqPV) for latest updates.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosephrocca%2Fopencharacters","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjosephrocca%2Fopencharacters","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosephrocca%2Fopencharacters/lists"}