SoruSora

Feature Overview

/chat

/translator

Table of Contents

• Why you should use SoruSora over the others?
• Commands
  • About
  • Arcaea
    • /arcaea linkplay
  • Channel
    • /channel language
    • /channel translator
  • Chat
    • /chat clear
    • /chat token
    • /chat tutorial
  • Dashboard
  • Dice
  • Help
  • Ping
  • Translator
• How to Set up and Run
  • Setting Environment Variables
  • Description of each environment variable
  • Running with Docker (Recommended)
  • Running without Docker
• Architecture
• How to Contribute
• License

Why you should use SoruSora over the others?

• Transparency through Open Source: SoruSora is not only entirely free but also open source, ensuring transparency in its operations. Users can monitor and verify that SoruSora maintains ethical practices without any hidden agendas.
• Privacy-first Design: SoruSora is designed with privacy in mind. Any sensitive information is encrypted and stored securely, ensuring that user data is protected from unauthorized access.
• Localized to All 29 Discord Languages: Everything including command names, descriptions, and instructions are automatically changed based on the current Discord language setting for each user. SoruSora is especially great if your server is international.
• Intuitive User Interface: Designed with a focus on user experience, it features intuitive elements like slash commands, providing a more straightforward alternative to traditional message commands. Moreover, SoruSora fully utilizes widgets such as Listbox and Buttons, eliminating the need for excessive typing and adding reactions to a message.

Commands

About

Show the information about SoruSora

Arcaea

/arcaea linkplay

Create an embed to invite people to your Link Play.

Channel

/channel language

Set or remove the main language of the channels.

The translator will use the main language as the source language for all messages in the channels.

/channel translator

Set or remove a translator for channels.

For every message sent in the selected channels, SoruSora will translate the message into the selected languages and reply with the translations.

If the main language of the channels is not selected using /channel language, the language used in the message will be detected automatically.

It supports 45 languages, namely Albanian, Arabic, Azerbaijani, Basque, Bengali, Bulgarian, Catalan, Chinese (Simplified), Chinese (Traditional), Czech, Danish, Dutch, English, Esperanto, Estonian, Filipino, Finnish, French, Galician, German, Greek, Hebrew, Hindi, Hungarian, Indonesian, Irish, Italian, Japanese, Korean, Latvian, Lithuanian, Malay, Norwegian (Bokmal), Persian, Polish, Portuguese, Romanian, Russian, Slovak, Slovenian, Spanish, Swedish, Thai, Turkish and Ukrainian.

Chat

To chat with SoruSora, either mention her or reply to her.

/chat clear

Clear the chat history between you and SoruSora.

/chat token

Set the token that will be used to chat with SoruSora.

/chat tutorial

Teach you how to chat with SoruSora.

Dashboard

Display the dashboard that contains configurations and statistics.

Dice

Roll some dice. The result is a random number between 1 and 6 with equal probability.

Help

Teach you how to use SoruSora.

Ping

Check the response time of SoruSora.

Translator

Set or remove a translator that translates all of your messages to other languages.

It supports 45 languages, namely Albanian, Arabic, Azerbaijani, Basque, Bengali, Bulgarian, Catalan, Chinese (Simplified), Chinese (Traditional), Czech, Danish, Dutch, English, Esperanto, Estonian, Filipino, Finnish, French, Galician, German, Greek, Hindi, Hungarian, Indonesian, Irish, Italian, Japanese, Korean, Kyrgyz, Latvian, Lithuanian, Malay, Norwegian (Bokmal), Persian, Polish, Portuguese, Romanian, Russian, Slovak, Slovenian, Spanish, Swedish, Thai, Turkish and Ukrainian.

How to Set up and Run

Setting Environment Variables

Create .env file, copy and paste all contents from .env.example file, and fill the values for your development environment.

Description of each environment variable

Name	Description
BOT_TOKEN	Token for your own Discord bot
TEST_GUILD_ID	(Optional) Find your test server id following the guide. If provided, the bot runs in development mode.
AI_TOKEN	Token for Gemini API. You can create one here for free
ENCRYPTION_KEY	Key for encrypting and decrypting the user token

Running with Docker (Recommended)

Run the following command:

# For Production
docker compose pull && docker compose up -d

# For Development
docker compose -f docker-compose-dev.yml up --build -d

Running without Docker

• Install uv, MongoDB and FFmpeg

• Start MongoDB

• Install Python 3.11

uv python install 3.11

• Pin the Python version

uv python pin 3.11

• Run main.py

uv run src/main.py

Architecture

How to Contribute

Read CONTRIBUTING.md for details.

License

SoruSora is licensed under the MIT License.