Skip to content
View HontoUKI's full-sized avatar
πŸ€“
Building Maria β€” local AI character engine
πŸ€“
Building Maria β€” local AI character engine

Block or report HontoUKI

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
hontouki/README.md

Hi, I'm Rustam πŸ‘‹

I'm a software engineering student and developer interested in backend architecture, fullstack development, AI/LLM integration, automation, and local AI character systems.

Currently, I'm building Maria β€” a local AI character engine / desktop companion project focused on personality, memory, emotional state, relationship dynamics, and long-term interaction.

🧠 About me

  • πŸŽ“ Software engineering student
  • πŸ’» Interested in backend, fullstack, AI systems and automation
  • πŸ› οΈ I like building projects that combine code, behavior logic and system architecture
  • πŸ€– Currently focused on local AI characters, LLM pipelines and character-based agents
  • πŸ“š Improving my skills in OOP, testing, clean backend architecture and project structure

πŸš€ Main project

Maria is a local AI character project built around:

  • persona and behavior rules
  • memory and context systems
  • affection / trust / mood mechanics
  • relationship and emotional state dynamics
  • opinion evolution
  • local LLM integration through Ollama
  • API layer for external clients
  • future Unity / Live2D integration
  • regression tests for behavior stability

The goal is not just to create a chatbot, but to build a more realistic character system with presence, personality and long-term interaction.

Debug WebUI and Screenshots

The screenshots and frontend showcase are available in a separate repository:

Maria AI Character Engine Debug WebUI

This WebUI is a developer/debug cockpit for Maria AI Character Engine. It is not the final user-facing Live2D/Unity client, but it demonstrates how the backend runtime can be observed and tested through a lightweight React/Vite interface.

It includes:

  • live conversation view;
  • daily dialogue history;
  • runtime/debug state panel;
  • relationship and mood parameter display;
  • proactive message support;
  • sprite overlay preview;
  • API integration with the Maria backend.

This main repository focuses on the backend engine, architecture, tests and runtime logic.
For visual screenshots and the current web interface, see the Debug WebUI repository.

πŸ› οΈ Tech stack

Languages

Python JavaScript C%23 PHP

Backend / Frontend

Flask FastAPI React

AI / Tools

Ollama Git Unity

πŸ“Œ Current focus

  • Building Maria, a local AI character engine
  • Improving backend architecture and OOP skills
  • Learning testing, regression safety and cleaner project structure
  • Exploring local LLMs, Ollama, Unity and Live2D integration

πŸ“« Contact

Pinned Loading

  1. Maria-AI-Character-Engine-Debug-WebUI Maria-AI-Character-Engine-Debug-WebUI Public

    Developer WebUI / debug cockpit for Maria AI Character Engine

    JavaScript

  2. Maria-AI-Character-Engine Maria-AI-Character-Engine Public

    Local AI character engine with memory, personality, emotional state and LLM integration.

    Python 3

  3. Telegram_Bot Telegram_Bot Public

    NSTU Helper project-bot v1

    Python