Casual Character Chat - Help & Guide

0 / 0

Send Anonymous Feedback

Found a bug or have an idea? Let me know! This form is 100% anonymous, no personal data is collected.




1. Introduction & Core Concept

What is this App?

Welcome! This is a fully functional application designed for creating, managing, and interacting with your own detailed AI characters. The core feature is the ability to engage in dynamic, text-based role-playing chats with any characters you want. The app has been developed from scratch with the aim of being easier, more intuitive, and faster to use than other platforms.

Who am I?

Hi, my name is Michel and I'm just an Austrian guy in his 30s who enjoys these AI character roleplays himself a lot. Although there are many good character chat platforms, there were always things that bothered me. Either they lacked certain features, weren't user-friendly enough, didn't have the best AI models, or required payment. So I decided to simply program my own platform with all the features I wanted. Then I thought, why not just make it freely accessible to everyone? And so, a new AI character chat application was born, freely accessible to everyone while keeping your data 100% private. Have fun with it! :)

I'm still developing and improving this app and try to implement even more and better features, while keeping it super simple to use for anyone. So, stay tuned for more cool Updates!

How Does It Work?

The user interface (the Frontend) is a live web application that runs directly in your browser. When you send a message, it's sent to a central, secure cloud server (the Backend). This server securely adds your API key and forwards the request to the AI. This system is simple for you and keeps your API key safe.

A Note on Your Data & Privacy

Your privacy is paramount. All of your data—including every character you create, all your chat histories, images, and your personal settings—is stored directly on your computer inside your browser's secure IndexedDB database. This technology allows for large amounts of data to be stored privately and offline. This means your data remains entirely on your device and is preserved even after you close the browser tab. No one else, including the developer, can access your characters or conversations.

2. The Main Screen: Character Selection

This is the first screen you see when you open the app. From here, you can access all of your characters and core features.

The Top Bar (Header)

The header provides access to the app's main functions:

⭐ The Favorites Bar

This bar gives you quick access to your most-used and favourite characters. To add a character to this bar, simply hover over their card in the main list below and click the star icon (★) in the top-right corner.

🔎 The Search Bars

To help you find specific characters quickly, the app features two separate search bars:

The Character List & Character Cards

This is the main area where all of your non-archived characters are displayed as individual cards, automatically sorted in alphabetical order. Clicking a card takes you to that character's chat dashboard. When you hover over a card, two buttons appear:

🗑️ The Bulk Delete Button

Here you can select and delete multiple characters or even all characters with a single click if you want.

🗃️ The Archive

If your character list gets too crowded or you simply want to hide a character, you can move characters to the archive to keep your main screen clean. This section appears at the bottom of the screen once you have at least one archived character. Click the "Show" / "Hide" button to expand or collapse the list of archived characters.

3. The Chat Dashboard: Your Conversation Hub

After clicking on a character card from the main screen, you'll land on their personal dashboard. This is the central hub for all your conversations with that specific character.

The Top Bar

The Character Header

This central element displays the character's avatar and name, along with two important management functions:

The Chat List (Saved Chats)

This section shows all the separate chat sessions you have saved with this character. Each character can have dozens of independent conversations.

4. The Character Editor

This is where you bring your characters to life. You can access the editor by clicking the 🤖 + Create Character button on the main screen or the Edit Character button on a character's chat dashboard. Any changes you make in this character editor will take effect immediately for the character, without having to refresh the site (even during chats).

The Editor Header

The Input Fields in Detail

Dynamic Scenario Management

Scenarios are pre-written starting points for a chat. This is perfect for setting up a specific scene or situation. Each scenario consists of a Title (for your own reference) and a Description, which usually contains the opening message of the chat.

Optional: At the beginning of the scenario description, you can add an "Out-of-character note" for the AI with important meta information about the scenario. It has usually even higher priority for the AI than the character description. For example: If your character description says that the character is good, then you can simply write in an OOC-note that the chracter is evil in this scenario. You can add other OOC-notes also in your messages during the chat anytime, whenever you need to clarify things for the AI. A note could look like this for example:

### OOC: {{user}} is the equivalent of Natsuki Subaru and replaces him in this scenario. Emilia plays a cold and detached opponent of {{user}}. Elsa Granhiert plays a trustful and loyal ally of {{user}}.
---
Scenario: [Here comes your actual scenario description with a starting scene, including first message of your character if you want.]

5. The Chat: Interacting with the AI

This is where the magic happens. The chat screen is designed to be immersive and give you a high degree of control over the conversation and its appearance.

The Chat Header

The bar at the top of the chat screen provides context and quick access to important features.

The Settings Panel

This panel gives you deep control over the look and feel of the chat and the AI's responses. All settings are saved locally and automatically applied to all chats.

The Chat Window & Message Interaction

This is the main area where your conversation is displayed.

The Input Area

This is where you write your messages.

Other Chat Functions

6. Who Are You? Persona Management

While most of the app is about the AI characters you chat with, the Persona system is all about defining who you are in the conversation.

The Difference: Character vs. Persona

The Persona Management Window

You can access this feature by clicking the 🎭 Manage Personas button on the main screen. This will open a dedicated modal window where you can:

The Persona Editor

The Persona Editor is a streamlined version of the Character Editor, designed for quickly defining your user profile.

Using a Persona in a Chat

Inside a chat, if you have not yet assigned a Persona, a 🎭 Select Persona button will be visible in the header. Clicking it opens a selection screen where you can choose one of your saved Personas for that specific chat session.

Important: This choice is final for that chat. Once a Persona is set, the button disappears to lock in the context for the AI.

7. All Together: Group Chats

You aren't limited to one-on-one conversations. Any chat can be turned into a group chat with multiple AI characters interacting with you and each other.

Starting a Group Chat

To add more characters to an existing conversation, simply click the Add Participant (👥+) button in the chat header. This will open a selection modal where you can choose any of your other characters to join the chat.

Managing Participants

Addressing Specific Characters in a Group Chat

To direct your message to a specific character in the group, you must use a simple command: Start your message with a forward slash / followed immediately by the character's name (e.g., /Akame "How are you?").

The AI is instructed to respond only as the character you addressed. If you don't specify a character, the response will come from the chat's primary character.

However, to be certain, always put the instruction “Reply only as {{char}} now” in the Character Reminder. It will ensure that only your targeted character will speak.

8. Import, Export & Backups

Your data is stored locally in your browser, which means it's private but also vulnerable if your browser data is cleared. The Import and Export feature is the best way to safeguard your creations.

Why should I use this feature?

How to Export Your Data

Exporting creates a single .json file containing all your characters and personas.

  1. Click the ⬇️ Export button in the header of the main screen.
  2. Your browser will open a "Save File" dialog.
  3. The file will be named casualcharacterchat_export_[date].json. Choose a safe location on your computer and click "Save". That's it!

How to Import Your Data

Importing allows you to load a previously exported backup file as well as any other .json file with characters in the same format.

  1. Click the ⬆️ Import button in the header.
  2. Select the .json backup file from your computer.

A confirmation window will apear. Once you confirm, the app will load the data. A success message will appear, telling you exactly how many characters and personas were successfully imported. Your existing data will NOT get overwritten and is save! Only the new data will be added to your existing characters and Personas.

9. Frequently Asked Questions (FAQ)

Here are answers to some common questions and issues.

Q: My AI's responses are weird/short/repetitive. What can I do?

A: The quality of AI responses depends heavily on your settings and prompts. If you're not getting the results you want, try the following:

Q: The app is slow, or the AI isn't responding. What's wrong?

A: The app relies on a cloud server to process AI requests. If that server is experiencing high traffic from many users at once, it can cause slowdowns. The app is designed to be robust; it will automatically retry sending your request several times. If you still don't get a response, the best solution is to wait a few minutes and try again.

Q: The chat was working, but now I always get an error like "AI Model did not respond...". What's wrong?

A: This can basically only mean two things: Either the AI model itself has problems and is overloaded (in which case there is nothing we can do but use another model), or you have reached a rate limit with OpenRouter. In the free plan, you only get 50 free messages per day (in practice, often only 38 or so). However, if you add a one-time $10 to your OpenRouter account, you will have 1,000 free messages per day and never have to worry about limits again.

Q: What's the difference between Character Description and Lorebook?

A: Think of it this way: The Character Description defines who the character is—their active personality, their appearance, how they behave right now. The Lorebook contains background knowledge that the character has—memories, historical facts, details about the world, etc. This separation helps the AI focus on the active personality while still being able to pull from deeper knowledge when needed. You can also integrate all kinds of additional facts about the character in the lorebook that are not necessary or have less relevance for the character description.

Q: Can I use my characters on another computer or in a different browser?

A: Yes. This is precisely what the Export and Import functions are for. Use Export on your old device/browser to save your data to a file, then use Import on the new one to load it all back in.

IMPORTANT: If you want to run your app on another device, you must copy your app folder with the three code files (index.html, style.css, script.js) to that device. Only then can you start the app on that device by opening the index.html file in the browser as usual.

Q: How do I get updates for the app?

A: You don't have to do anything! Since this is an online application, you are always using the latest version automatically whenever you open the page.

Q: Why can I only select my Persona once per chat?

A: Your Persona's details are permanently "baked into" the context of a chat session when you select it. This is crucial for the AI to maintain a consistent understanding of who you are throughout a long conversation. If you could change it mid-chat, it would confuse the AI and break the story's continuity. If you want to use a different Persona, you must start a new chat.

Q: Why are my Characters and Personas suddenly gone?

A:

A: This means that your browser's site data (including the IndexedDB database) has been deleted. This can happen when you clear your browser's cache or have settings that automatically delete site data upon closing the browser. (This is also why you don't have any characters when you open the app in an incognito tab — because permanent data storage is disabled there.) That's why the quick and easy "Export" feature is your best insurance. Simply export your data after making major changes or creating new characters, and you're safe.

10. Getting Started (Required Setup)

The Only Step: Connect Your API Key

To use any AI models, the app needs your personal API key of course. This is the only setup step required.

The app itself is free, but AI model usage is billed through your own key. Use OpenRouter.ai because it gives you access to many different models in one place. You get 50 free messages a day. If you add 10$ to your OpenRouter balance (one-time payment) you get 1,000 free messages per day forever.

  1. Create a free account at OpenRouter.ai.
  2. Go to your account settings and create a new API Key. Copy this key.
  3. In Casual Character Chat, click the "⚙️ Global App Settings" button in the header.
  4. Paste your key into the "Your OpenRouter API Key" field and click "Save Settings".

That's it! The app is now fully configured and ready to use.

A Note on "Cold Starts"

The app uses a free central server to handle requests. If the server hasn't been used for a while, it goes to "sleep". Your very first message might take 20-50 seconds to get a reply while the server "wakes up". This is normal. After the first message, all other responses will be fast.


--- END ---