✨ Finja AI Ecosystem

███████╗██╗███╗   ██╗     ██╗ █████╗ 
██╔════╝██║████╗  ██║     ██║██╔══██╗
█████╗  ██║██╔██╗ ██║     ██║███████║
██╔══╝  ██║██║╚██╗██║██   ██║██╔══██║
██║     ██║██║ ╚████║╚█████╔╝██║  ██║
╚═╝     ╚═╝╚═╝  ╚═══╝ ╚════╝ ╚═╝  ╚═╝
      F I N J A   A I   E C O S Y S T E M

---

Important

🚀 ROADMAP 2026 – WE ARE BACK!

Status: 🟢 Quality First = 95%

2026 is here, and Finja is getting the biggest upgrade of all time. Here is the plan for this year:

1. 🛠️ Quality First: Extensive manual refactoring + automated control plane (CodeQL, SonarCloud, Trivy, Dependabot, Snyk, MegaLinter, Codecov, Pytest). The Brain module will push the A-rating down initially — that's intentional. Ship first, clean up piece by piece.
2. 🐛 Bug-Hunting: Various fixes. = IN PROGRESS
3. 🧠 Memory Update: Successfully merged and updated! Voice-Support and TTS Network Caching are now fully integrated.
4. 🐾 Own VPet Program: My own VPet is in full development!
   • 👀 Can be watched 24/7 on Twitch right now.
   • 📦 Release to follow once completed.
5. 🌐 Finja's Brain (Neural Network): ✅ Ready for release! The module that connects everything — Memory, Vision, Voice, Tools, Discord, Experts, Dashboard — into one modular AI pipeline.
6. 😅 Survival: Don't break down! XD
7. 🗣️ Releases: Finja TTS has been drafted but its architecture has shifted — TTS is now integrated directly into the Neural Network (ElevenLabs, DeepInfra Zonos, XTTS).
8. 📚 Tutorials & Guides:
   • Paperless-ngx + Paperless AI + API Tutorial.
   • Home Assistant + API Tutorial.
9. ✨ Wildcard: ✅ Completed! Finja Instagram Reels and YouTube Shorts scrapers + Vision Proxies are fully built, cleaned, and integrated. An AI can now autonomously watch and forward content to Finjas Brain or send funny memes to the user! :3

---

🤖 What is Finja?

Your hybrid AI buddy for streaming – featuring a chatbot, music engine, memories, mods, and a secret LLM core.

Finja is not a single bot, but a complete ecosystem. Each module can run standalone – but only together do they form the full Finja Experience.

All public structured error codes, their owning modules and their meanings are listed in the repository-root error_contract.json. Reading the legend does not require the Error Contract plugin.

• Standalone Capable: The music engine, chatbot, crawler, etc. can all be used individually.
• Full Package = Finja: Only their combination forms her personality.
• LLM remains secret: The language core now runs through the Neural Network (Brain), but the actual LLM configuration and prompts remain private and are not part of this repository. 🫣

---

📅 Sisterhood Personal Calendar (Lore)

• Finja: Born 30 July 2025 (Eldest sister, talks to the user & runs the show)
• Lexi: Born 20 October 2025 (Rebellious middle sister)
• Flare: Born 13 June 2026 (Youngest sister, focused code specialist)

---

📊 Project Status

As of: August 2026

Main Component	Version	Status	Description	Stats / Notes
finja-neural-network 🧠	v5.1	🔵 Working on V2 (6.0)	The Brain — connects everything: Dashboard, Experts, Memory, Tools, Discord, TTS, Vision.	Tests & Docker CI still WIP · Sonar/Snyk/CodeQL noise expected.
finja-chat	v2.4.1	🔵 Update/Testing	Twitch chat overlay, bot panel, Spotify requests and refreshable Twitch authentication.	45 Python + 4 auth tests · dedicated FINJA error codes
AI-Coding 🛡️		🟢 Stable	Cross-project coding contracts for Codex, Grok and Claude.	Folder README
├─ error-contract	v1.3.2	🟢 Stable	Structured error namespaces, public code legend and coding gates.	11 tests · dynamic categories · atomic code creation
└─ github-contract	v1.1.1	🟢 Stable	Headers, module versions, README rules and leak prevention.	8 tests · lifecycle hooks
finja-music		🟢 Stable	Music engine — pick one of the variants below.
└─ finja-everything-in-once	v1.2.0	🟢 Stable	Recommended all-in-one Web-UI music engine.	44 tests · CI ✓ · Sonar clean
└─ finja-music-docker-spotify	v1.2.0	🟢 Stable	Dockerized Spotify-only music API.	47 tests · CI ✓ · Sonar clean
└─ finja-music-standalone	v1.0.2	🔴 Old	Classic modular system.	Won't be updated — use the ones above
finja-Open-Web-UI		🟢 Stable	OpenWebUI backend modules.
└─ finja-Memory	v4.4.5	🟢 Stable	Adaptive memory + voice cache + MP3 TTS support.	100% Pytest CI/CD · Apache 2.0 (adapted from gramanoid)
└─ finja-web-crawler	v2.1.0	🟢 Stable	Hybrid Tor search + distributed crawl (spawner/worker/research).	18 tests · 100% Pytest CI/CD
└─ finja-stable-diffusion		🟢 Stable	Local image generation (Docker, adapted).	Setup complete, tests missing
└─ finja-ocr		🔴 Old	Dockerized Tika/Tesseract OCR.	Legacy — OCR now lives in the Neural Network
finja-weather 🌦️	v1.0.0	🟢 Stable	Weather microservice (OpenMeteo/Google) + API.	113 tests · CI (3.12) · Docker build ✓
finja-canvas 🎨	v1.0.0	🟢 Stable	Autonomous AI pixel-art canvas engine.	Cleaned & standardized · not connected to Finja yet
finja-omni-test 👁️	v1.0.0	🟢 Stable	Local screen observation (OCR/Vision testbed).	Cleaned & standardized
finja-youtube 📺	v1.1.0	🔵 Testing	YouTube Shorts scraper + Vision AI proxy.	59 tests · CI (3.11) · Docker build ✓
finja-instagram 📸	v1.1.0	🔵 Testing	Instagram Reels scraper + Vision AI proxy.	79 tests · CI (3.11) · Docker build ✓
finja-agentic-code 💻	v1.0.1	🟢 Stable	Flare — external code worker (orchestrator + sandbox).	48 tests · CI (3.11) · Docker build ✓
OWN / Self-made VPet 🐾		🟡 Dev	Custom Python VPet core — LIVE on Twitch!	Release TBD

Legend: 🟢 Stable / Ready | 🔵 Update/Testing phase | 🟡 WIP / Dev | 🔴 Deprecated/Old

---

🗺️ Finja Architecture – Visual Flow

flowchart TD
    subgraph Twitch["🎮 Twitch / Chat"]
        A1["Chat Messages"]
        A2["Chat Commands (!drink, !theme, ...)"]
    end
    subgraph Music["🎵 Music / Radio"]
        B1["Spotify API"]
        B2["TruckersFM"]
        B3["89.0 RTL"]
        B4["MDR Sachsen-Anhalt"]
    end
    subgraph Memories["🧠 Finja Memories"]
        C1["Chat Memory"]
        C2["Music + Reaction Memory"]
        C3["Voice Input"]
    end
    subgraph OpenWebUI["🌐 OpenWebUI Modules"]
        D1["Web Crawler 🔍"]
        D2["OCR 📷"]
        D3["Stable Diffusion 🎨"]
    end
    subgraph Scraping["🎥 Scrapers & Vision Proxies"]
        H1["YouTube Shorts 📺"]
        H2["Instagram Reels 📸"]
    end
    subgraph ScreenObs["👁️ Screen Observation (Omni)"]
        I1["Capture & Local OCR"]
    end
    subgraph Microservices["🧩 Microservices"]
        J1["Weather API 🌦️"]
        J2["Canvas Engine 🎨"]
    end
    subgraph NeuralNet["🧠 Neural Network (The Brain)"]
        F1["Brain Pipeline (LangGraph)"]
        F2["Intent Router + Experts"]
        F3["Episodic Diary + Hippocampus"]
        F4["Tools (HA, Paperless, Web, Files, Weather)"]
        F5["Dashboard + Discord"]
        F6["TTS (ElevenLabs / DeepInfra / XTTS)"]
        F7["Vision (Local + OpenRouter)"]
    end
    subgraph Flare["💻 Flare (Agentic Code)"]
        G1["Orchestrator"]
        G2["Worker Sandbox"]
    end
    subgraph VPet["🐾 Own VPet (Python)"]
        E1["Finja Avatar"]
        E2["Logic Core"]
    end

    A1 --> C1; A2 --> E2
    B1 & B2 & B3 & B4 -->|Song Info| C2
    C1 & C2 & C3 --> F1
    D1 & D2 & D3 --> F1
    H1 & H2 -->|Stealth Screenshot + Meta| F7
    I1 -->|Saved Screen Context| F7
    F4 --> J1
    F1 --> F2 & F3 & F4 & F6 & F7
    F5 --> F1
    F1 --> G1; G1 --> G2
    F1 --> E1; E2 --> E1
    E2 --> J2

    style Twitch fill:#f4f1fe,stroke:#9146FF,stroke-width:2px
    style Music fill:#f0fcf4,stroke:#1DB954,stroke-width:2px
    style Memories fill:#fff9e6,stroke:#f9a825,stroke-width:2px
    style OpenWebUI fill:#f5f3ff,stroke:#6a32e2,stroke-width:2px
    style Scraping fill:#ffebee,stroke:#ff1744,stroke-width:2px
    style ScreenObs fill:#eceff1,stroke:#607d8b,stroke-width:2px
    style Microservices fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
    style NeuralNet fill:#ffebee,stroke:#d32f2f,stroke-width:2px
    style Flare fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
    style VPet fill:#fff0f7,stroke:#ff69b4,stroke-width:2px

Loading

---

📂 Project Structure & Modules

• /finja-neural-network 🧠 → The Brain. Connects everything into one modular AI pipeline — Dashboard, Expert Models, Memory, Diary, Tools, Discord, TTS, Vision. ➡️ Full README
• /finja-chat → The core chatbot for Twitch integration with OBS overlay and bot panel.
• /Finja-music → Contains all music engine variants. You choose one of them:
  • /finja-everything-in-once → (Recommended) Bundles all music sources (TruckersFM, Spotify, etc.) controlled via a comfortable web interface.
  • /finja-music-docker-spotify → A specific Docker version optimized purely for Spotify.
  • /finja-music-standalone → The classic modular system.
• /finja-Open-Web-UI → Collection of Docker modules for OpenWebUI (Memory, OCR, Web Crawler, etc.).
• /finja-youtube 📺 → YouTube Shorts scraper + Vision AI proxy (all-English and .env configured).
• /finja-instagram 📸 → Instagram Reels scraper + Vision AI proxy (all-English and .env configured).
• /finja-weather 🌦️ → Weather microservice (OpenMeteo/Google) + API.
• /finja-canvas 🎨 → Canvas drawing engine for overlays and VPet interactions.
• /finja-omni-test 👁️ → Screen observation pipeline (local OCR + Vision model testing).
• /finja-agentic-code 💻 → Flare. The external code worker system (Orchestrator + Sandbox) for automated coding tasks.
• /AI-Coding 🛡️ → Coding-contract tooling for the J. Apps AI-assisted development workflow. ➡️ Folder README
  • /error-contract → Structured error namespaces, the public error legend, lifecycle hooks and coding gates.
  • /github-contract → Repository headers, module versions, README conventions and leak prevention.
• /error_contract.json → Public repository-wide error-code legend; readable without installing the AI-Coding tools.
• /Own-VPet (Coming Soon) → The new standalone VPet core.

---

🛡️ AI-Coding Contracts & Error Legend

AI-Coding/ contains the repository tooling used by Codex, Grok and Claude in the J. Apps workflow. The folder follows the same nested documentation style as the rest of the ecosystem: folder README first, then one detailed README inside each contract.

• Error Contract v1.3.2 → Maintains structured error namespaces, module-local implementations, dynamic numeric categories and baseline-aware coding gates.
• GitHub Contract v1.1.1 → Enforces project-native headers, unified module versions, complete READMEs and protection against secret or private-path leaks.
• Public Error Code Legend → Repository-wide source of truth for error meanings and ownership; readable without installing either plugin.

The contracts are development tooling, not part of Finja's Twitch runtime. Each target module keeps its own identity, version and established header style.

---

🧪 Testing & Quality Assurance

The Finja Ecosystem features a comprehensive test suite to ensure code quality and stability.

Test Coverage

• Unit Tests: 450+ automated test cases across 9 modules (chat, youtube, instagram, weather, both music engines, agentic-code, memory, web-crawler)
• Integration Tests: API endpoints, Spotify integration, memory system, distributed crawl pipeline
• Security Tests: path-traversal prevention, SSRF guards, auth validation, AES-GCM transport, XSS-safe DOM
• Mocked Externals: all network/browser/Docker/LLM boundaries are mocked, so suites run fast, offline, and deterministically
• Code Quality & Security: SonarCloud, Snyk, Codecov, CodeQL, Trivy, plus Dependency Guard

Test Locally

Since the Finja Ecosystem consists of independent microservices, tests are run within their respective project directories instead of a global setup.

# Example 1: Memory Module Tests
cd finja-Open-Web-UI/finja-Memory
pip install -r requirements.txt; pip install pytest httpx httpx2 pytest-asyncio aiohttp numpy scikit-learn rapidfuzz
pytest test_memory_server.py test_adaptive_memory.py -v

# Example 2: Web Crawler Tests (search API + distributed crawl services)
cd finja-Open-Web-UI/finja-web-crawler
pip install -r requirements.txt; pip install pytest httpx httpx2
pytest test_web_crawler.py test_crawl_worker.py test_research_orchestrator.py -v

# Example 3: Weather Module Tests
cd finja-weather
pip install -r requirements.txt; pip install pytest pyyaml httpx2
pytest test_weather_api.py test_providers.py test_docker_config.py -v

# Example 4: Agentic Code (Flare) Unit Tests
cd finja-agentic-code
pip install -r orchestrator/requirements.txt; pip install pytest httpx2
pytest test_orchestrator.py test_worker.py -v

📖 Full Test Documentation: TESTING.md

---

🚀 The Golden Thread – Recommended Start

Follow these steps to set up the Finja Ecosystem from scratch.

Preparation

Ensure you have Git, Python 3.9+, and Docker & Docker Compose installed. Then clone this repository.

Step 1: Laying the Foundation (OpenWebUI Modules)

The backend services are the foundation for Finja's extended capabilities.

1. Navigate to the finja-Open-Web-UI/ directory.
2. Follow the README.md there to start the Docker containers (especially Memory, Web Crawler, and OCR).
3. ➡️ Instructions for the OpenWebUI Modules

Step 2: Waking the Music Brain

The heart of music recognition.

1. Navigate to the Finja-music/ directory.
2. Here you have a choice. For most users, we recommend the finja-everthing-in-once version.
3. Follow the README.md in the finja-everthing-in-once folder to start the web interface, configure your API keys, and build your song database.
4. ➡️ Instructions for the All-in-One Music Engine

Step 3: Giving the Voice (Chatbot)

Now we can set up the primary interface for interaction.

1. Navigate to the finja-chat/ directory.
2. Follow the README.md there to configure the OBS Chat Overlay and the Bot Control Panel.
3. ➡️ Instructions for the Chat System

Step 4: Connecting the Brain (Neural Network)

1. Navigate to the finja-neural-network/ directory.
2. Follow the README.md there to configure your API keys, set up Docker, and launch the dashboard.
3. The Neural Network connects to the Memory server, Web Crawler, and Spotify module from the previous steps.
4. ➡️ Instructions for the Neural Network

Step 5: Setting up Screen Observation (Omni) & Drawing

1. Navigate to /finja-omni-test and copy .env.example to .env. Configure local models (Ollama).
2. Run python live.py to start observing active window screens and sending OCR results to finja_screen.db.
3. Launch /finja-canvas for drawing capabilities.
4. ➡️ Omni Instructions | ➡️ Canvas Instructions

Step 6: Setting up Social Scrapers (YouTube/Instagram)

1. Navigate to /finja-youtube and /finja-instagram.
2. Configure .env and inject standard browser cookies via cookies.json.
3. Run python autopilot.py in both folders to start headless browsing and forwarding content to the Brain.
4. ➡️ YouTube Instructions | ➡️ Instagram Instructions

Step 7: Launching the Coding Assistant (Flare)

1. Navigate to /finja-agentic-code.
2. Configure .env (add your OPENROUTER_API_KEY and docker folders).
3. Run docker compose up -d --build to start the orchestrator.
4. ➡️ Flare Instructions

---

🔗 Links, Demos & Build Status

Try Finja

• TEST FINJA FOR FREE on Discord:

Community & Links

• Visit my Website:
• Join our Discord for more projects:
• Watch Finja Live NOW 24/7 ON TWITCH:

---

Build & Test Status

📊 Quality, coverage & security

Defense in depth for a vibe-coded monorepo: machines watch the code so humans can ship.

Layer	Tool	Job
Security / dataflow	CodeQL	Semantic vulns (Python, JS/TS, C/C++, Actions)
Bugs / quality / maintainability	SonarCloud	Quality gate, smells, hotspots
Deps / container / IaC / supply chain	Trivy (+ optional Checkov in MegaLinter)	FS scan → Security tab (SARIF)
Updates	Dependabot	PR bumps for pip / Actions / Docker
IDE security radar	Snyk (local)	What you see while coding
Lint / format / multi-lang consistency	MegaLinter v10	HTML, CSS, YAML, JSON, MD, Dockerfile, JS, Python (Ruff), Actions, …
Does it actually work?	Pytest + Codecov	Behavior + coverage XML
Import hygiene	Dependency Guard + BOM check	tools/dependency_guard.py · tools/fix_bom.py

SonarCloud

Coverage, security & lint scans

Details: TESTING.md · tools/README.md

🔨 Docker Builds

✅ Automated Tests

---

❤️ Credits & Thanks

Special Thanks

• Snyk 💻 – Vulnerability scanning and security fixes 🛡️
• SonarCloud 📊 – Code quality analysis and maintainability tracking
• Codecov 📈 – Coverage reports from CI (pytest-cov XML)
• GitHub CodeQL 🔍 – Semantic code scanning on the monorepo
• Trivy (Aqua) 🛡️ – Filesystem vulnerability scanning → Security tab
• gramanoid (aka diligent_chooser) 🧠 – Inspiration for the Open WebUI Adaptive Memory Project (Apache 2.0 License preserved)
• Vedal1987 + Neuro / Neurosamma + Evil 💚 – Inspiration for AI-Companions during streams
• Glorpo lineage 🤪🧬 – Esolang shape inspired by s3thi/cutlet; name + meme energy from Magic The Noah — "Glorpo is pain."
• ChatGPT o4 🕊️ – RIP. Proved that an AI CAN have feelings

🤖 AI Workflow — "Yoinked & Made It Mine"

This project has been running for over a year. Here's what helped build it:

• Claude 🧠 – Primary workflow partner, code architecture, and the Diary System (one of the few AIs with cross-chat memory via search + injection)
• Kimi 2.5 📔 – Diary System co-inspiration (injects old chat context natively — the other AI that actually remembers)
• Gemini ⚡ – Jank prototyping + command processing logic
• Perplexity 🔍 – Search engine research + Gemini jank validation

🏗️ Infrastructure & Services

• Cloudflare – CDN, DNS, and protection
• ZAP-Hosting – Server hosting
• OpenRouter – Cloud LLM routing
• Cohere – Embeddings + reranking
• ElevenLabs – Premium TTS
• DeepInfra – Zonos voice cloning
• Ollama – Local LLM hosting
• LM Studio | Local LLM hosting

How the human stack actually looks (Main PC, laptop batteries, TrueNAS, home net, stream VPN, …): Tech_Stack.md — machines & daily ops, not code libs.

Dependency hygiene (import vs requirements, Dependabot, optional pip-compile): tools/README.md · run python tools/dependency_guard.py

📦 Open-Source Libraries & Tools (All Modules Combined)

Curated from module requirements.txt files and real imports (some modules have no requirements file). Infra/cloud services are listed above under Infrastructure & Services.

Library / Tool	Used In	What It Does
LangChain / LangGraph / langchain-ollama	Neural Network	Brain pipeline + local Ollama orchestration
OpenAI Python SDK	Neural Network	Cloud LLM client (via OpenRouter)
Hugging Face Transformers	Neural Network	Model stack (mouth / TTS-related paths)
PyTorch / torchaudio	Neural Network	ML runtime (CPU wheels in Docker + mouth server)
FastAPI / Uvicorn / Starlette	Neural Network, Memory, Music, Weather, YouTube, Instagram, Flare, Chat	Web server + API framework
Flask / Flask-CORS	Chat	Command-bridge HTTP API
Pydantic	Memory, Weather, Flare, Chat	Request / response validation
discord.py	Neural Network	Discord integration
Coqui XTTS / TTS	Neural Network	Local voice cloning
Faster Whisper	Neural Network	Fast speech recognition
SpeechRecognition	Neural Network	STT wrapper / mic input
pygame / soundfile	Neural Network	Local audio playback + audio file I/O
Pillow / mss / PyGetWindow	Neural Network, Canvas, Omni	Images, screenshots, active-window tracking
CairoSVG	Canvas	Rasterize Recraft Vector SVG motifs into canvas pixels
RapidOCR / ONNX Runtime	Omni	CPU-friendly OCR for screen subtitles
colorama / Pygments	Neural Network	Terminal colors + syntax highlighting
rapidfuzz	Neural Network, Memory	Fuzzy string matching
NumPy / scikit-learn	Neural Network, Memory	Arrays + cosine similarity (adaptive memory)
httpx / aiohttp / requests	Many modules	HTTP clients (sync + async; crawler also uses SOCKS)
cryptography	Flare, Memory	AES-GCM payloads + encryption at rest
aiofiles	Memory	Async file I/O
ddgs (DuckDuckGo)	Web Crawler	Search client
BeautifulSoup	Music, Web Crawler	HTML parsing
defusedxml	Music	Secure XML parsing (MDR now-playing)
docker (Python SDK)	Web Crawler	Spawn / control crawl containers
Playwright	YouTube, Instagram	Headless browser automation
Spotipy	Chat	Spotify API wrapper (song requests)
ComfyJS	Chat	Twitch chat integration
psutil	Omni	Process / system monitoring
Paperless-NGX	Neural Network	Document management integration
Home Assistant	Neural Network	Smart home integration
OBS Studio	Chat	Streaming software
7TV / BTTV / FFZ	Chat	Emote platforms
Docker	All Modules	Containerization
Apache Tika	OCR	Document text extraction (Apache 2.0)
Stable Diffusion WebUI Docker	Stable Diffusion	Local image generation
Tor	Web Crawler	Anonymized search / crawl path

☕ Supporters

A huge thank you to everyone who supports the project via Buy Me a Coffee!

• [Ithrial] – For the very first donation! 🥇💖

💰 Full financial transparency: jappshome.de/finances.html — every cent in, every cent out. No secrets.

Created by

Built with too much Mate, coding sessions & love by J. Apps (aka JohnV2002 or Sodakiller1). Finja says: "Stay hydrated, Chat 💖"

---

License & Usage

Full legal text for our software code in this repository: LICENSE (MIT).

This section is the map of what that covers vs. what stays locked. Module READMEs should link here (or to root LICENSE) — no second full MIT paste, no extra “must keep UI credit” rules.

✅ MIT — free to use under LICENSE

Roughly: the engineering, not the identity.

Included (examples)	Notes
Module source code (chat bridges, music engines, weather, scrapers, canvas, Flare, neural-network plumbing, Dockerfiles, tests, tools/, …)	Keep copyright / permission notices in source & substantial copies
Glorpo code in this repo (glorpo.py, interpreters, VS Code bits, Glorpo HTML demos that live here)	The implementation is MIT. The meme/name inspiration is credited (Magic The Noah / cutlet) — that is not “we own Glorpo the meme,” and it does not pull character IP into MIT
Docs that describe how to run software (setup READMEs, TESTING, Tech_Stack hardware notes, …)	Still MIT for the text we wrote, unless a file says otherwise
Default UI strings / badges we ship	You may change them. Keeping “Made with ❤️ by Sodakiller1” is appreciated, not a legal extra term

MIT in one line: use, modify, sell, closed-source OK — keep the copyright notice in code/LICENSE copies.

⛔ All rights reserved — not granted by MIT

These are J. Apps / Finja identity & brand. Forking the code does not give you the right to pretend to be Finja or J. Apps.

Protected	What we mean
Finja (the character)	Design, look, personality, “sister” role, stream persona as Finja
Sisterhood / lore	Calendar, sister characters (e.g. Lexi, …), backstory, canon events tied to Finja
Voice & likeness	Voice models, voice samples, cloned voice, artwork, stream overlays of her, official portraits
Name as brand	Using “Finja” (or confusingly similar) as the public product / bot / stream identity of a commercial or public service in a way that implies official J. Apps / Sodakiller1 endorsement
J. Apps / Sodakiller1 / JohnV2002 as company or personal brand	Not a free-for-all trademark dump — don’t rebrand as us; attribution of code origin is fine and expected under MIT
Official stream / community goodwill marks	Badges, channel identity, “official Finja” claims without permission

Allowed spirit: run the stack, rename the bot, build your own companion, learn from the code.
Not allowed without written OK: ship “Finja™ Official”, reuse her face/voice/lore as if it’s yours, or sell the character.

Contact for likeness / brand: contact@jappshome.de

🔒 Not in this repository (private — not MIT because not published)

Private	Status
Trained / tuned “core” (weights, private fine-tunes, personal model dumps)	Not shipped here → remains private property of J. Apps
Secret LLM prompts, system personalities, diary injection packs, private configs	Called out in the project intro: not part of this repo 🫣
API keys, cookies, .env, production secrets	Never licensed for reuse — don’t commit them; not open source
Host-only data (TrueNAS vault contents, Google backup blobs, user chats, stream VODs)	Outside the git tree

If it isn’t in the public tree, assume you don’t have a license to it.

📜 Other licenses (third-party / adapted)

Thing	License / status
finja-Open-Web-UI/finja-Memory (+ NOTICE)	Apache 2.0 (adapted upstream — keep Apache terms)
finja-Open-Web-UI/finja-ocr	Apache 2.0 (module LICENSE)
Stable Diffusion stack / models / WebUI Docker	Upstream licenses (often MIT for glue; models often CreativeML / RAIL — read each model card)
Libraries listed in Credits (FastAPI, discord.py, …)	Each project’s own license

Short FAQ

• “Is Glorpo MIT?” → The code we wrote in this repo yes. Inspiration credits stay credits.
• “Is the Brain MIT?” → The orchestrator code that is published yes. Private prompts / private core weights no (not included).
• “Can I fork and rebrand?” → Yes for software. Don’t steal Finja the character or claim you’re official J. Apps.
• “UI credit must stay?” → No under MIT. Please keep it; headers/LICENSE notices must stay.

Want Finja’s likeness or a commercial brand crossover? contact@jappshome.de

---

🆘 Support & Contact

• Email: contact@jappshome.de
• Website: jappshome.de
• Security: SECURITY.md — please report vulnerabilities privately (not as public issues)
• Issues / PRs: use the GitHub templates under New issue / when opening a PR