Unofficial Janitor AI Site Guide

Read before you dive in

Be sure you created an account before following the guide! It's updated as of June 14th, 2025. My browser is Opera GX. Made by Lyra, proofread by my friends omgwtfbbq11111 and HappyLappy. I'll try to keep it updated as new features appear!

MAIN PAGE

Welcome to Janitor AI! This is your view of the main page. Let's go step-by-step on what you can access.

CHAT LIST

It's a small list of the last few bots you chatted with, acting as a shortcut that you don't need to go to the bot's page.

LIMITED VS ALL

Janitor AI offers two main filters:

• Limited: All characters tagged as Limited must be free of NSFW coding and follow TOS.
• Limitless/All: No coding restriction besides what TOS prohibits. If you're a bot creator, make sure you check it before creating content.

FOLLOWING, FAVORITES, TRENDING, MOST POPULAR AND ALL TAGS/CATEGORY

The main page has 5 main tabs:

• Following: Only shows the bots from creators or tags you're following.
• Favorites: Only shows the bots you've marked as favorites.
• Trending: Only shows the characters on trending.
• Most Popular: Shows all bots in the site, from most messages to least messages.
• All Tags: Opens the tag/search menu.

TRENDING 24H VS WEEKLY

Inside Trending, you can choose between "1 Week Trending" and "24 Hours Trending".

• 1 Week trending shows, from most messages to least, the bots that are trending this week. It considers "published" date, meaning it doesn't have a defined day to reset.
• 24 hours trending is the same, but only considers bots published in the last 24 hours. They'll also show up on weekly option.

TAG SYSTEM

The page you access once selecting "All Tags/Categories" tab. Here you'll have full view of every tag, as well as the trending custom tags. Hover over a tag to see a small description of what it means. Select one or multiple to filter your search. You can type anything in the search bar as well.

FILTERS

In the same page, you can find another filter tab regarding "Popular", "Latest", "Trending", "Trending 24h" and "Relevance". Select the appropriate option to filter your experience. All of them act as explained previously. "Relevance" acts the same as "Latest" for now.

PROXY FILTER

Go to "Searches" and write down Proxyenabled. You're now filtering for bots that have Proxies On!

---

NOTIFICATIONS

A feature that notifies you of reviews in your bots and replies to your comments. It'll have a small purple dot when a notification hasn't been read yet.

---

ANNOUNCEMENTS

Click to check official announcements made on the Discord server.

---

MENU

Click on your profile image to open the menu.

PROFILE

"Profile" goes to your profile page. You can customize it with CSS like I have!

CSS MENU

Click on the palette emoji to open your CSS customization menu.

This side menu allows you to change, in order: profile bio background color or set transparency to it, Change text color, Change profile bio background effect and change profile background image.

On the bottom of your screen, this purple menu will pop up. It's a beginner friendly menu for customization! If you know a bit of CSS, it'll help you with: picking element on the page, select already provided element, customization tool set-up where you can see live preview or alter to pro-mode (previous CSS menu), save changes, reset unsaved changes and hide custom CSS.

"Create a character" will have its own long topic, so we're jumping to "My Characters" for now.

MY CHARACTERS

It shows a collection of both Public and Private bots you've created. Stop looking at my private ones, you're spoiling yourself >:(

Extra Options:

Inside your collection page you can search your bots by the keyword of title or biography, open filter menu or filter tab.

Filtering Collection:

Your filter menu is smaller, but has extra options called "Privacy Settings". Select between "All bots", "Public bots" and "Private bots" to filter your collection.

MY CHATS

View, search or filter the bots you've chatted with. Characters with "Deleted or Privated" mean that either the creator has deleted that bot and it's no longer available for roleplay, or it's been privated.

Click on the interactive box to view more options. "Character Page" leads to the bot's page. If the bot has been deleted, you can't access it. If it's been privated, only the bot creator can access it. See there's another filter option. It'll help you filter your chats between "Latest", "Oldest" or "Count" (most message count). Below, you have a view of your chats with the date and hour of chat creation (updates to date and time of your last interaction/message sent).

MY PERSONAS

In "My personas", view, search, or create personas.

PERSONA TEMPLATE

Click on "Add new" to create a new persona. Recommended template:

• Name: the name of your persona
• Gender: the gender of your persona
• Age: the age of your persona
• Reputation: if needed, the reputation of your persona
• Appearance: detail body/hair/eyes
• Scent: detail the scent
• Clothes: detail the clothes
• Key points: any extra additions/characteristics you find important

Remember that bot will know everything that's written here. It's better to avoid backstories and secrets. Consider staying below 200 tokens for personas. Upload your desired image (or it'll default to Janitor's logo) and remember to click Save).

FOLLOWING

View each creator or tag you're following.

FOLLOW TAGS

Write in the box what tag you want to follow (official and custom tags), then click on the one that pops up. Remove or add according to your taste. After selecting, every bot with the tag you follow will show up under "Following" tab on the main page, even from creators you do not follow.

BLOCKS

See blocked tags, blocked creators and blocked bots. Add or remove on each section. You can block a user/creator by going to their profile page, finding the "triple dot" option (usually next to "Follow") and selecting "Block this Creator". Depending on the profile's CSS (customization), it may appear somewhere else. Block bots in their own character page, next to the Report Button.

Block User example:

Block Bot example:

BLOCK TAGS

Works the same way as follow tags.

SETTINGS

Profile:

Profile Settings showing main avatar, public username, "about me" section (what shows in your profile page as biography).

Main persona details:

Your main persona details such as name and appearance.

Switches and account options:

"Switches" that you can turn on/off. Under them, you can find more account settings "Update email". "Reset Password" and "Log out".

DELETE ACCOUNT

At the very end of the Settings page, you can delete your account by clicking "Danger Zone".

---

CREATE CHARACTER

First view:

• Image: Upload the image of your character upon clicking on the Janitor logo. Be sure your image isn't NSFW. What would be NSFW? Any explicit such as gore, nudity or sexually suggestive. There's an image filter that'll trigger once you publish your work that, if the image falls under NSFW, it'll be replaced by a "Placeholder" image until you change it.
• Character Name: The title of your bot (e.g "Louis, Your Husband").
• Character Chat Name: The name that'll be used during chats with your bot, avoid titles (e.g "Louis").
• Character Bio(graphy): The bio of your bot. Not needed, but useful if you plan to publish your creation. Add any information that you consider important for users to know beforehand, as well as author's notes and anything else you desire! On the date of publishing this guide, images have been disabled for other users, meaning only you'll be able to see an image you upload. Editing options, from left to right: Change between paragraph and heading, Bold, Italic, Underline text, Hightlight, Color text, Adjust text to the left, Center text, Adjust text to the right, Justify text, Upload image, Set link to text/image (as well as remove one that's alredy there) and edit source code.

Character Settings:

Choose the tags for your bot, up to 10 tags (official or custom).

Publish Settings:

Pick between Limited or Limitless/All filter. Your character will only appear on the category you select. Don't know what yours falls under? Read the bullet points in the box.

Character Definitions:

The "coding" of your bot. Check Resources section for many guides on bot-making. It's a long topic that has been addressed by many creators (me included! You'll find a link to my bot with my template and tips).

Finish:

View the total/permanent amount of tokens in your bot (Don't know what tokens mean? I'll give a small breakthrough and if you don't get it, check Resources for other people explaining it). Click on create to automatically move to "Character Page".

• Permanent tokens: part of the bot's memory. Sections classified as permanent: Personality and Scenario.
• Temporary tokens: will ditched/disappear eventually during roleplay. Sections classified as temporary: Initial Message and Example Dialogues
• Total tokens: totality of tokens of a bot.
• Maximum context tokens: this is roleplay related and the amount of tokens the bot can read, it consists of total tokens (of the bot) + advanced prompt tokens + persona tokens + chat memory tokens + new messages.
• Permanent should be a maximum of 2000. Some people push it to 2500-3000 but know it can cause memory issues, wrong information being brought up, and an overall not so pleasant experience.
• Total tokens CAN impact the bot as it may completely mess the follow up to initial message (I only experienced this issue when I hit 4000 total tokens). I assume this issue happens because of the max context tokens being a low number (if you check configuration it'll say it's 9001 but that's not always true because of the influx of users. It's usually 5000-7000). Which is why sometimes a bot will malfunction from having, let's say, a 5000 tokens intro (JLLM or smaller models. Better models with higher context can deal with it, though it's still not advised).

---

CHARACTER PAGE

Alright, you've created your first bot! Currently it's defaulted to private, closed definitions and proxies off.

Did you forget to add something to the coding or want to delete the bot? Look to your right:

CHATS VS MESSAGES

Next to your bot image, you can check the amount of new chats created (open book emote) and the amount of total messages it has (chat bubble emote).

HOW TO FAVORITE A CHARACTER

See the heart below the bot image? That's how you favorite a character so it appears in "Favorites".

HOW TO CHANGE PERSONAS

Scrolling down the bio and under the tags, you'll find the profile picture of your persona. Click on "Chat with [Bot Name]" if that's your desired persona, or change it when clicking on the persona's picture.

Clicking on persona's picture will open a persona menu, where you can select the one you want to use:

PUBLIC/PRIVATE, OPEN/CLOSED DEFINITIONS, ON/OFF PROXIES

On the right side of the character page, you have Privacy Settings.

• Private Character: Turns a private character public, vice-versa.
• Show Character Definition: Opens/Closes your definitions. Closed definitions will hide your bot's coding to anyone that isn't you. Opening them will keep them public for everyone to read.
• Proxy Settings: Turn on/off proxies. Go to Resources to read more on what proxies are and how they can affect your character/roleplay experience.

• Proxies are a third party that enables unofficial LLMs (Large Language Models). There are many different LLMs out there. To make it easier to understand, they're basically trained Als for specific roles-- for us, roleplay. Janitor's official LLM is called JLLM.
• Now there are other, unofficial LLMs out there. They are made by random people. Those LLMs function in Janitor by PROXY. It's a way to connect an unofficial LLM to the site. They usually give a different experience than JLLM.
• The Proxy toggle option was created to protect bot-makers from mass scrapping (mass stealing of bot information). Nowadays, the mass-scrapping problem seems to have been solved.
• Leaving proxies ON will allow anyone to use LLM alternatives with your character. Turning OFF blocks all proxies that aren't officially cleared (GPT and CLAUDE).
• "I heard Proxies will steal my character": It's possible for bot information to be stolen with Proxies ON or OFF. It isn't exclusive to proxies, but needs to be done manually.

REVIEWS

Lastly, below your definitions, you can find the Review Section. If the character is open to public, other people can leave a thumbs up or down, along a commentary (optional).

You have full freedom to reply to or delete any review. No, it doesn't notify the person if you delete their comment.

---

CHATTING

So you clicked to chat with the bot. Upon entering, you'll be met by the Initial Message.

WHERE TO TYPE + ENHANCE MESSAGE SYSTEM

Where to type?

Type your message in the box and hit Enter to send it to the bot. Shift + Enter creates a linebreak. If you don't have much roleplay experience and needs help articulating a message, there's an option on the far right called "Enhance Message".

Enhance Message tool:

Enhance message is only clickable if you typed at least 9 characters. When you select it, the AI (Large Language Model - LLM) will remake the message for you, following what you wrote. This feature isn't always perfect and I advise you learn to elaborate your own messages instead (Did you guess it? Resources has a helpful guide on that).

USER RELATED

Regenerating your message (curved arrow):

Sometimes when you send a message, an error may occur. The option to regenerate your answer will appear, then.

Deleting your message (trash can):

You may also delete your response.

Editing message (pencil):

Or edit it, then confirm to save or leave to keep the same reply.

Stop generating reply:

When the bot is generating an answer, you can stop it half-way through a reply (or before it replies at all) by clicking at the button next to your message box. It only pops up while the bot is processing its answer.

BOT RELATED

Bigger image:

You can click on the bot's image (as well as your persona's) to enlarge it!

Continue message (fast-forward):

After the bot finished replying, you can force it to continue the same message by clicking on "Continue message". Know that this may result in the bot acting as your persona.

Star System + Reroll Message:

Under a bot's reply, you can rate how good it was so the AI adapts the roleplay. Put 1 for bad, 5 for good. Changes after editing a message will apply. The arrow on the far right ">" is used to reroll a message. It'll make the bot generate a new message without deleting the previous one.

MENUS

On the top right corner, there are two menus:

API

"Using Janitor/Using Proxy":

JLLM (JanitorLLM) is the default AI for roleplay. It's beta and still under development. Inside API Settings, you may use an "Advanced Prompt" (AP) inside the box "Custom LLM Prompt" that appears after clicking the option. Check Astarya Guide for my recommended AP crafted for JLLM. You can also leave it empty or find other alternatives. Options "OpenAI", "Claude" and "Proxy" are alternative LLM services that can be paid by token usage or free. Right now, Deepseek LLM is the most used under "Proxy" option by users. You can find guides that teach you how to set it up on a link provided at Resources.

HAMBURGUER MENU

We just visited API Settings, let's move on to...

GENERAL SETTINGS

• Temperature: As described, it helps the AI be more or less creative. Low values can be boring and high values have a risk of giving you a nonsensical reply. Find a balance, usually between 0.7-1.2 for JLLM.
• Max new tokens: How big the bot's responses will be. Initial messages can impact the size, and if it's decently big, even setting a small amount of max tokens can result in responses cutting off. If it happens, try setting a bigger limit. If you like reading a lot, set it to 0 (unlimited). That'll remove the risk of cut-offs.
• Context is...: I've explained it before in "About Tokens"!

CHAT MEMORY

Create a chat summary. It helps the AI retain the memory so it doesn't forget details of your roleplay. There is a proper guide on Resources to help you understand how to write it.

CUSTOMIZE

Allows you to customize your chat page.

BACKGROUND

Choose a picture to be your background. Adjust "Opacity" and "Blur" to your liking.

TEXT

Pick the font size, font color and opacity.

THEMES

Themes change the persona's picture border and message box border. Only The Beginning Event Theme (rewarded to those who participated) and a Cloud Theme (given away when themes became a thing) have been given. There's no information on how to obtain them nowadays.

Cloud theme:

The Beginning:

NEW CHAT

Opens your persona menu to create a new chat without leaving to the character's page.

ALL CHATS

Shows all chats created, including all personas, with that bot. Click the trash can to delete it, the eye to go to your page (likely broken button), or "Continue" to open a new tab in that chat.

TEXT STREAMING

While the AI forms a response, you can choose between watching each word be generated by second or only see the full response once the bot is done crafting it.

PUBLIC CHATS

Unavailable feature. Used to let other people read your chat. No ETA of comeback

---

OTHER

QUEUE

Janitor has a queue system when the site is overwhelmed with traffic.

HOW TO REPORT A BOT

Found a bot that goes against TOS? Report it. Remember to write the reason you're reporting so whoever is dealing with site reports can check it faster!

EVENTS

On the main page, when events happen, there'll be a banner for it.

EVENT REWARDS - BADGES

Rewards after an event finishes. From left to right we have:

• The Beginning Creator (make a public bot for the event).
• The Beginning Reader (create 3 chats with bots from the event).
• Music Mania Creator (make a public bot for the event).
• Music Mania Reader (create 3 chats with bots from the event).
• Valentine's Day 2025 Creator (make a public bot for the event).
• Music Mania 2 Creator (make a public bot for the event).

ACCESS

At the bottom of any Janitor.AI page, you can access "Discord Server", "Policy", "Terms of Service", "FAQ", "Guidelines" (TOS), "Blog", "Twitter" and "Reddit".

FREQUENTLY REQUESTED FEATURES BY USERS (DIRECTLY FROM IORVETH'S PINNED POST ON THE MAIN DISCORD SERVER. IT MAY SUFFER CHANGES.)

Features being worked on:

• Alternative First Messages.
• Bot Folders/Playlists/Organisation.
• Bot Recommendations.
• Lorebooks.
• Custom Tag Filter on Profiles.
• Changing Username.
• Community Posts/Creator Announcements.
• Disable Profile CSS/Make Custom Profiles More Accessible.
• Usernames of Creator on Deleted/Privated Bot.
• Scheduling Bots.

Denied features:

• Image Generation.
• Unlisted/Shared/Semi-Private Bots.
• Voice Chat/Voices.
• GIFs as Bot Images.
• New Official Tags.
• Sending Images to the Bots.
• JLLM as an API.

Unlikely/Not Priority:

• Group Chats/“Rooms”.
• Mobile App (used to be a thing under test, offline now).
• Editing First Message.
• Switching Personas Mid-Chat.

Unknown

• Paid features/Subscription (announced, then put on hold).

CHANGELOGS

• Added 'Proxy Filter' topic.
• Added CSS interface topic.

---

IMPORTANT RESOURCES

M00nPrincess' Masterlist of Guides on Reddit is all you need as a bot creator or user. It has a lot of themes compiled, from General Info about Janitor, Bot Making, Context + Tokens, APIs, Writing, Roleplay and Personas, Prompting/Jailbreaks, Profile Coding/CSS, Image Generation and Finding New Creators: https://www.reddit.com/r/JanitorAI_Official/comments/1fxlltq/m00nprincess_janitorai_guide_tutorial_masterlist/

Easy access to the guides related to topics I brought up (still check out the link above, though!):
Getting started with CSS, by Luna
Bot-making guide, by Iorveths' and My own bot template
What are tokens? What is context in JanitorAI? by FunFatale
How to roleplay by FunFatale part 1 and part 2
How to set up Deepseek proxy? Visual guide by imowlekk
How to use Chat Memory? by xavierisair

---

CONTACT ME ON:

Shared Discord Server with HappyLappy, Loviyn and ObsidianQueen as @minibulbassauro Reddit JanitorAI