https://github.com/josephrocca/opencharacters

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.
https://github.com/josephrocca/opencharacters

chatbot chatgpt openai

Last synced: 3 months ago
JSON representation

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.

• Host: GitHub
• URL: https://github.com/josephrocca/opencharacters
• Owner: josephrocca
• License: mit
• Created: 2023-03-06T11:03:26.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-04-28T10:52:51.000Z (6 months ago)
• Last Synced: 2024-05-23T06:14:03.376Z (6 months ago)
• Topics: chatbot, chatgpt, openai
• Language: HTML
• Homepage: https://josephrocca.github.io/OpenCharacters
• Size: 2.9 MB
• Stars: 361
• Watchers: 16
• Forks: 60
• Open Issues: 26
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-ChatGPT-repositories - OpenCharacters - 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. (Browser-extensions)

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.)

![banner](https://user-images.githubusercontent.com/1167575/225629372-eb4de08a-ed62-4660-a83d-6e42a5c092d7.jpg)

Similar to CharacterAI, but open source, and with much deeper character customization.


⟶ Try it! ⟵


Discord Server


## Features:

* 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).

* All your data is stored in your browser's local storage (again, there is no server).

* Share characters with a link - all character data is embedded within the link.

* Auto-summarization algorithm (for old messages) which extends effective character memory/context size massively.

* 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.

* Add lorebook(s) to your character, and add thread-specific lore with the `/lore` command.

* 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).

  * Give your character access to the internet

  * Create your own slash commands

  * Give your character a video avatar (custom code has its own iframe & can display arbitrary content)

  * Create a "game master" [with a separate AI-powered process](https://tinyurl.com/5t3x8pdk) that tracks your abilities, inventory, etc.

  * Create your own memory structures (embedding, retrieval, etc.)

  * Give your character an internal thought process that runs alongside the chat

  * Give your character a voice via the browser's built-in TTS, or via an external API like ElevenLabs

  * Characters can [edit their own personality and custom code](https://tinyurl.com/4ccnn9zb) - self-improving and change over time

  * Allow your character to execute [Python](https://github.com/josephrocca/OpenCharacters/blob/main/docs/running-python-code.md) or JavaScript code.

* Currently supports OpenAI APIs [and most Hugging Face models](https://github.com/josephrocca/OpenCharacters/blob/main/docs/custom-models.md).

* Easily import character files and conversation data most other formats.

* Send new feature ideas or bug reports [here](https://github.com/josephrocca/OpenCharacters/issues) or on our [Discord server](https://discord.gg/5tkWXJFqPV).

## Changelog

Please see the `#announcements` channel on the [Discord server](https://discord.gg/5tkWXJFqPV) for latest updates.