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 πŸ‘‹

Software engineering student Β· Backend / Fullstack Developer Β· AI Character Systems

I build systems where code, behavior logic, memory, perception and long-term interaction meet.

Currently working on M.A.R.I.A. β€” an author-driven local AI character ecosystem built around a single-user Core runtime, external clients, memory, personality, relationship dynamics and the feeling of presence.


🧠 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 runtimes
  • πŸ“š Improving my skills in OOP, testing, clean backend architecture and project structure
  • βš™οΈ I use AI tools as accelerators, but I focus on understanding, reviewing and shaping the architecture myself

πŸš€ Main project

An author-driven ecosystem for local AI character systems.

M.A.R.I.A. is my personal long-term AI character ecosystem.

It is not just a chatbot, generic assistant or companion SaaS.
The goal is to build a more realistic local character system with presence, personality, memory, subjective perception and long-term continuity.

The ecosystem is centered around:

Canonical single-user runtime and architectural heart of the ecosystem.

M.A.R.I.A.-Core is built around:

  • persona and behavior logic
  • memory and context systems
  • Maria's perception of user messages
  • affection / trust / mood mechanics
  • relationship and emotional state dynamics
  • opinion and preference evolution
  • local LLM integration through Ollama
  • FastAPI-based API contracts for external clients
  • regression tests for behavior stability
  • future external clients such as WebUI, Voice, CV, Avatar / Live2D and Discord integrations

πŸ–₯️ Debug WebUI and Screenshots

Developer/debug cockpit for observing and testing M.A.R.I.A.-Core runtime behavior.

The Debug WebUI is not the final user-facing Live2D/Unity client.
It demonstrates how the Core 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 / Live2D preview experiments
  • API integration with M.A.R.I.A.-Core

M.A.R.I.A.-Core focuses on runtime architecture, tests, memory, behavior and AI character systems.
M.A.R.I.A.-WebUI focuses on visual inspection, development tooling and frontend experimentation.


πŸ› οΈ Tech stack

Languages

Python JavaScript C%23 PHP

Backend / Frontend

Flask FastAPI React

AI / Tools

Ollama Git Unity


πŸ“Œ Current focus

  • Building M.A.R.I.A.-Core as a single-user local AI character runtime
  • Designing a cleaner Core / external clients architecture
  • Improving backend architecture, OOP design and API contracts
  • Strengthening tests, regression safety and project structure
  • Exploring local LLM pipelines, memory systems and character-based agents
  • Turning Maria from a technical prototype into a long-term authored AI character system

πŸ“« Contact


This profile is part of my path as a developer, system thinker and creator of M.A.R.I.A.

Pinned Loading

  1. M.A.R.I.A. M.A.R.I.A. Public

    Author-driven local AI character ecosystem built around M.A.R.I.A.-Core

  2. M.A.R.I.A.-Core-Sanitized-Snapshot M.A.R.I.A.-Core-Sanitized-Snapshot Public

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

    Python 5

  3. M.A.R.I.A.-WebUI M.A.R.I.A.-WebUI Public

    Developer WebUI / debug cockpit for Maria AI Character Engine

    JavaScript

  4. Telegram_Bot Telegram_Bot Public

    NSTU Helper project-bot v1

    Python