Skip to content

README.md

Latest commit

 

History

History
45 lines (32 loc) · 1.5 KB

README.md

File metadata and controls

45 lines (32 loc) · 1.5 KB

Pardus Mihmandar

Pardus Mihmandar is an AI assistant for Debian and Debian-based Linux users. It is designed for beginners who need clear explanations, safe command guidance, hosted AI credits, and optional local AI through Ollama or LM Studio.

Monorepo

app/            Tauri desktop app: Svelte + TypeScript + Rust
web/frontend/   Website and dashboard: Svelte + TypeScript
web/backend/    API backend: PHP 8.4 + Laravel
docs/           Architecture, API, security, development docs
docker/         Deployment support
scripts/        Setup, dev, and test helpers
memory-bank/    Project planning memory

MVP

  • Website landing page, login, register, dashboard, credits, usage, providers, settings
  • Laravel auth, credits, provider settings, AI request logging, OpenAPI skeleton
  • Desktop login, chat shell, provider selector, local Ollama/LM Studio connection tests
  • Safe command explanation and approval UI
  • Notes, tasks, snippets, and diagnostics skeleton

Safety Rule

AI-generated commands are never executed automatically. Risky commands must be explained, reviewed, and explicitly approved by the user.

Setup

See docs/development.md for full local setup.

Frontend Production Deploy

web/frontend now uses an explicit SvelteKit Node adapter (@sveltejs/adapter-node).

Build and run:

.\.tools\node\npm.cmd run --prefix web/frontend build
$env:PORT="4173"
$env:ORIGIN="http://localhost:4173"
$env:VITE_API_BASE_URL="http://localhost:8000/api"
node web/frontend/build