🧠 Maatix — AI Builder Platform

Maatix is a desktop-first AI creation platform that allows users to design, customize, and interact with personalized AI agents. Each AI can be tuned in terms of personality, tone, memory, and behavior — and then used in a real chat interface powered by LLMs (Groq).

The long-term vision is a full multi-platform ecosystem:

• 💻 Desktop app (Electron) — core product
• 🌐 Web version — browser-based AI builder
• 📱 Mobile app — AI on the go

---

🚀 Core Idea

Maatix is a no-code AI identity builder.

Users can:

• Create custom AI agents
• Define personality, tone, and memory style
• Train or simulate behavior through prompts
• Chat live with their personalized AI
• Expand into voice cloning and advanced memory systems (future roadmap)

Think of it as:

“Figma for AI personalities”

---

---

⚙️ Tech Stack

Backend

• FastAPI (Python)
• Groq API (LLaMA models)
• SQLAlchemy (database layer)
• Pydantic (validation)
• dotenv (environment config)

Frontend

• Electron (desktop app)
• React (UI)
• TypeScript (type safety)
• TailwindCSS (styling)
• Framer Motion (animations)

---

🧠 AI System Overview

The AI system works like this:

User Input (Frontend) ↓ Electron UI (Chat / Builder) ↓ FastAPI Backend (/chat) ↓ AI Profile (Personality + Memory) ↓ System Prompt Builder ↓ Groq LLM (LLaMA 3.3 / 70B) ↓ Response returned to UI

Each AI agent is defined by:

• Personality
• Tone
• Memory context
• System prompt template

---

🚀 Getting Started

1. Backend Setup

cd backend
python -m venv venv
venv\Scripts\activate   # Windows
pip install -r requirements.txt

Create .env file:
GROQ_API_KEY=your_api_key_here

Run backend:
python -m uvicorn main:app --reload --port 8000

Backend runs at:
http://localhost:8000
http://localhost:8000/docs

2. Frontend Setup (Electron App)
cd build-ai
npm install
npm run dev

Build Electron app:

npm run build

Run desktop app:

npm run start


💬 Key Features

🧠 AI Builder
Create custom AI agents
Define personality & tone
Save AI profiles to backend

💬 Live Chat Preview
Chat with your AI in real-time
Each AI behaves differently based on tuning

⚡ Groq-Powered Responses
Fast LLM inference
Low-latency chat experience

🧩 Modular Architecture
Backend and frontend fully separated
API-driven communication

🔮 Roadmap
Phase 1 (Current)
AI builder UI
Chat system
Groq integration

Phase 2
Streaming responses (ChatGPT-style typing)
AI memory system (persistent context)
Multi-AI switching dashboard

Phase 3
Voice cloning (user voice AI)
Mobile app version
Cloud sync system

🛡️ Notes
Never commit .env file
Backend must be running before frontend chat works
Groq API key is required for AI responses

👨‍💻 Author
Built as an experimental AI SaaS platform architecture focusing on:

AI personalization
Human-like agent design
Real-time LLM interaction systems
⚡ Vision

Maatix is not just a chatbot.

It is a system for creating digital identities powered by AI.