How senkuuuuu/amadeus works
Amadeus is a desktop character-chat application. Its main flow is login against a local SQLite database, a startup animation, then an asynchronous chat window: the user records speech, it is transcribed, sent to Character AI, analyzed for emotion, and answered with speech and matching character animation. The main window coordinates these stages and also manages conversation state. The README documents Character AI and UnrealSpeech integrations; source excerpts show the orchestration and local data/rendering links. Some audio and integration internals were not sampled, so those links are documented rather than inferred beyond the evidence.
Main entry points: amadeus_window.py Chat Window · log_in_window.py Login Window · main.py App Entry · handle_data.py Account and Chat Data
Components 22
Desktop Flow
- App Entry
main.py - Login Window
modules/windows/log_in_window.py - Startup Window
modules/windows/start_up_window.py - Chat Window
modules/windows/amadeus_window.py
Chat and Voice
- Audio Recorder
modules/functionality/record_audio.py - Speech Recognition
modules/functionality/voice_to_text.py - Character AI Client
modules/essentials/character_ai_async.py - Emotion Analysis
modules/essentials/emotion_analysis_hugging_face.py - Text-to-Speech
modules/functionality/text_to_voice.py - Speech Playback
modules/functionality/start_speaking.py
Visual Interface
- Sprite Fetcher
modules/data_handlers/fetch_sprites.py - GUI Element Generator
modules/essentials/pygame_obj_generator.py - Popup Dialogs
modules/essentials/dialog_box_tkinter.py - Animation Renderer
modules/essentials/renderer.py
Local Data
- SQLite Database
amadeus_database.db - Account and Chat Data
modules/data_handlers/handle_data.py - Resource Path Resolver
modules/data_handlers/executable_file_redirector.py - Task and Temp Cleanup
modules/data_handlers/cleaner.py
Other components
- Desktop User
- Microphone
- Character AI Service
- UnrealSpeech Service
Connections 28
- Desktop User → App Entry: launches
README.md - App Entry → Login Window: opens
main.py - Login Window → Account and Chat Data: checks credentials
modules/windows/log_in_window.py - Account and Chat Data → SQLite Database: queries
modules/data_handlers/handle_data.py - App Entry → Startup Window: opens
main.py - App Entry → Chat Window: starts chat
main.py - Startup Window → Animation Renderer: renders animation
modules/windows/start_up_window.py - Login Window → GUI Element Generator: creates controls
modules/windows/log_in_window.py - Login Window → Popup Dialogs: shows prompts
modules/windows/log_in_window.py - Login Window → Sprite Fetcher: loads artwork
modules/windows/log_in_window.py - Chat Window → Account and Chat Data: loads chat state
modules/windows/amadeus_window.py - Chat Window → Audio Recorder: records input
modules/windows/amadeus_window.py - Microphone → Audio Recorder: provides audio
- Chat Window → Speech Recognition: transcribes recording
modules/windows/amadeus_window.py - Chat Window → Character AI Client: sends user text
modules/windows/amadeus_window.py - Character AI Client → Character AI Service: requests response
README.md - Chat Window → Emotion Analysis: analyzes response
modules/windows/amadeus_window.py - Emotion Analysis → Sprite Fetcher: selects emotion sprites
- Chat Window → Text-to-Speech: speaks response
modules/windows/amadeus_window.py - Text-to-Speech → UnrealSpeech Service: requests speech
README.md - Chat Window → Speech Playback: plays generated audio
modules/windows/amadeus_window.py - Chat Window → Animation Renderer: renders chat animation
modules/windows/amadeus_window.py - Animation Renderer → Sprite Fetcher: loads sprites
modules/essentials/renderer.py - Chat Window → GUI Element Generator: builds interface
modules/windows/amadeus_window.py - Chat Window → Popup Dialogs: shows confirmations
modules/windows/amadeus_window.py - Chat Window → Task and Temp Cleanup: cleans up on exit
modules/windows/amadeus_window.py - Account and Chat Data → Resource Path Resolver: resolves database path
modules/data_handlers/handle_data.py - Sprite Fetcher → Resource Path Resolver: resolves sprite path
modules/data_handlers/fetch_sprites.py