Skip to main content

Marziel OS

🧠 Marziel OS — v1.0.1

Private AI Operating System — runs entirely on your hardware.

PyPI GitHub Stars HuggingFace MIT License

One command to boot your own AI OS — with MarzielFlow adaptive inference, 3-tier encrypted memory, and autonomous process management.

Marziel OS is a private AI operating system that transforms your machine into an intelligent, self-managing system. It features an AI kernel with persistent event loop, 3-tier memory (working → long-term → episodic), Unix-like process management, MarzielFlow adaptive inference optimization (T/Z distribution quantization, fuzzy logic, attention sink), TurboQuant KV cache compression, real-time maritime intelligence, and 12-route semantic intent routing — all without sending a single byte to the cloud.

Quick Install

pip install marziel
marziel serve

That's it. The right engine is auto-installed for your hardware. The first run downloads the model from Hugging Face. Everything is automatic.

What's New in v1.0.1

🧠 Marziel OS — The AI Kernel

Marziel is no longer just a chatbot. It's now a persistent operating system with:

  ╔══════════════════════════════════════════════════════════╗
  ║  🧠 Marziel OS v1.0 — Private Intelligence OS          ║
  ╚══════════════════════════════════════════════════════════╝

     Kernel:     active (heartbeat: 60s)
     Engine:     marziel-v6 (CUDA, 52.9 tok/s)
     Flow:       5 components (T/Z + ABQ + Fuzzy + Sink + Spec)
     Memory:     working=0 | long-term=2.4KB | episodic=156KB
     Processes:  0 running, 0 queued
     Security:   Sentinel active (anti-fingerprint, encrypted)

🔬 MarzielFlow — 5-Component Adaptive Inference

Component What It Does Impact
Speculative Decoding Prompt lookup draft/verify Higher throughput
T/Z Distribution Quantization Per-layer distribution detection + Lloyd-Max boundaries Better quality at lower bits
Adaptive Bit-Width (ABQ) 2/3/4-bit per layer by sensitivity 2.88-bit avg, memory savings
Fuzzy Logic Controller Mamdani-style adaptive resource control Smooth parameter adaptation
Attention Sink Cache StreamingLLM: 4 sink tokens + 1024 rolling window 75% memory savings

🖥️ OS API

GET  /os/status       — Full kernel + engine + memory status
GET  /os/memory       — 3-tier memory (working, long-term, episodic)
GET  /os/ps           — Process list (like Unix ps)
GET  /os/top          — Real-time resource monitor
POST /os/recall       — Semantic memory recall
POST /os/remember     — Store encrypted persistent memory
POST /os/schedule     — Schedule recurring tasks
POST /os/kill/:pid    — Kill a process

Features

Feature Description
🧠 AI OS Kernel Persistent event loop, heartbeat, task scheduler, signal bus
💾 3-Tier Memory Working (volatile) → Long-Term (AES-256 encrypted) → Episodic (permanent summaries)
⚙️ Process Manager Unix-like ps, top, kill with priority scheduling
🔬 MarzielFlow 5-component adaptive inference optimization pipeline
TurboQuant PolarQuant + QJL 3-bit KV cache compression (3x memory reduction)
🧠 AI Chat Conversational AI with personality, code generation, data analysis
📡 Maritime Intelligence Real-time GDACS, GDELT, NASA EONET, AIS, market data, bunker prices
💰 Market Data Live Brent crude, BDI, EU Carbon, freight rates, forex, 12-port bunker prices
🚢 Vessel Integration AIS tracking, fleet management, voyage data, maintenance records
🔌 Third-Party Connectors MarineTraffic, VesselFinder, Spire, Datalastic, or any REST API
🔍 Web Search Live internet results via DuckDuckGo — always up-to-date answers
🌐 Browser Control Headless Chromium automation — navigate, click, type, screenshot
🔗 URL Analysis Share any link — reads, extracts, and analyzes content
🐙 GitHub Analysis Paste any repo URL — get architecture, languages, README analysis
Autonomous Agent Multi-step reasoning with bash, file, web, browser, and maritime tools
📑 Hybrid RAG Upload documents → reasoning + vector search → answers with citations
🔒 100% Private Everything runs locally. Zero cloud dependency
🛡️ Sentinel Security Anti-fingerprinting, encrypted storage, secure memory wipe, zero telemetry

Architecture

┌─────────────────────────────────────────────────────────────┐
│                      MARZIEL OS v1.0                        │
│                                                             │
│  ┌──────────────────────────────────────────────────────┐   │
│  │ INTENT SHELL (12 semantic routes)                    │   │
│  │ "check vessels" → parse → schedule → report          │   │
│  └──────────────────────────────────────────────────────┘   │
│                           │                                 │
│  ┌────────────┐  ┌────────▼───────┐  ┌──────────────────┐  │
│  │ PROCESS    │  │ KERNEL         │  │ MEMORY MANAGER   │  │
│  │ MANAGER    │  │                │  │                  │  │
│  │            │  │ Event Loop     │  │ Working Memory   │  │
│  │ Task Queue │◄─┤ Scheduler      ├─►│ Long-Term (AES)  │  │
│  │ PID Table  │  │ Signal Bus     │  │ Episodic (JSONL) │  │
│  │ Lifecycle  │  │ Heartbeat      │  │ Semantic Recall  │  │
│  └────────────┘  └────────────────┘  └──────────────────┘  │
│                           │                                 │
│  ┌────────────────────────▼─────────────────────────────┐  │
│  │ INFERENCE ENGINE                                      │  │
│  │ MarzielEngine + MarzielFlow + TurboQuant              │  │
│  │ ┌──────────────────────────────────────────────────┐  │  │
│  │ │ T/Z Quant │ ABQ │ Fuzzy │ Sink Cache │ Spec Dec │  │  │
│  │ └──────────────────────────────────────────────────┘  │  │
│  └───────────────────────────────────────────────────────┘  │
│                           │                                 │
│  ┌────────────────────────▼─────────────────────────────┐  │
│  │ NEURONS (Axon + Dendrite + 8 Synapse types)           │  │
│  │ SENTINEL (Security: anti-fingerprint, encrypted vault) │  │
│  └───────────────────────────────────────────────────────┘  │
│                    YOUR MACHINE                             │
└─────────────────────────────────────────────────────────────┘

Maritime Intelligence (Enterprise)

Marziel integrates real-time maritime data from multiple global sources:

┌───────────────────────────────────────────────────────────┐
│                   MARZIEL MARITIME INTEL                   │
├───────────────────────────────────────────────────────────┤
│  OSINT (Free APIs)         │  Platform Integration        │
│  ─────────────────         │  ────────────────────        │
│  📡 GDACS — Disasters      │  🚢 Fleet Vessels            │
│  📰 GDELT — Geopolitics    │  🗺️  Active Voyages          │
│  🌍 NASA EONET — Climate   │  ⚠️  Risk Zones              │
│  💰 Yahoo Finance — Market │  🏗️  Maintenance             │
│  💱 ExchangeRate — Forex   │  📋 Incidents                │
│  🚢 AISStream — Tracking   │  ⛽ Fuel Records             │
│                            │  🏭 Port Directory           │
├───────────────────────────────────────────────────────────┤
│  Third-Party Connectors (Enterprise)                      │
│  ─────────────────────────────────                        │
│  MarineTraffic · VesselFinder · Spire Maritime            │
│  Datalastic · OpenWeather · Custom REST API               │
└───────────────────────────────────────────────────────────┘

Maritime API Endpoints

GET  /api/maritime/report           — Full intelligence report
GET  /api/maritime/data/market      — Live market data
GET  /api/maritime/data/bunker      — 12-port bunker prices
GET  /api/maritime/data/fx          — Exchange rates
GET  /api/maritime/data/gdacs       — Disaster events
GET  /api/maritime/data/gdelt       — Geopolitical news
GET  /api/maritime/data/nasa        — Natural events
GET  /api/maritime/data/ais         — Vessel tracking
GET  /api/maritime/data/vessels     — Fleet data
GET  /api/maritime/data/voyages     — Voyage data
GET  /api/maritime/data/risk-zones  — Active risk zones
GET  /api/maritime/data/ports       — Port directory
GET  /api/maritime/connectors       — List connectors
POST /api/maritime/connectors/query — Query third-party services

Requirements

  • RAM: 8GB minimum (16GB recommended)
  • Disk: ~5GB for the model
  • Python: 3.10–3.14
  • Supported platforms:
Platform Engine Model Auto-installed
Apple Silicon (M1–M4) MLX MLX 4-bit (4.5GB) mlx-lm
NVIDIA GPU (any) Marziel Engine GGUF Q4_K_M (4.8GB) llama-cpp-python
CPU (any x86/ARM) llama.cpp GGUF Q4_K_M (4.8GB) llama-cpp-python
  • Linux: Ubuntu, Debian, Arch, Fedora, RHEL, Alpine — any distro with glibc
  • macOS: Intel (llama.cpp) or Apple Silicon (MLX)
  • Windows: WSL2 recommended

Usage

# Install and boot
pip install marziel
marziel serve

# Check OS status
curl http://localhost:8001/os/status

# Store a memory
curl -X POST http://localhost:8001/os/remember \
  -H "Content-Type: application/json" \
  -d '{"key": "preference", "value": "maritime focus", "tier": "long_term"}'

# Recall a memory
curl -X POST http://localhost:8001/os/recall \
  -H "Content-Type: application/json" \
  -d '{"query": "preference", "tier": "auto"}'

# Schedule a recurring task
curl -X POST http://localhost:8001/os/schedule \
  -H "Content-Type: application/json" \
  -d '{"name": "vessel_monitor", "interval_seconds": 300}'

# Process management
curl http://localhost:8001/os/ps      # List processes
curl http://localhost:8001/os/top     # Resource monitor

Then open http://localhost:8001 — your private AI OS dashboard.

Pricing

Plan Price Features
Free €0/mo AI Chat, Web Search, URL Analysis, GitHub Analysis, OS Status
Pro €20/mo + Agent Mode, Browser Control, Process Management, Scheduling
Enterprise €199/mo + Maritime Intelligence, Connectors, Reports, Custom Fine-tuning

Links

Contact

📧 info@efkan-isazade.com

License

MIT License


Built with ❤️ by Efe (Efkan Isazade)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

marziel-1.0.1.tar.gz (353.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

marziel-1.0.1-py3-none-any.whl (363.6 kB view details)

Uploaded Python 3

File details

Details for the file marziel-1.0.1.tar.gz.

File metadata

  • Download URL: marziel-1.0.1.tar.gz
  • Upload date:
  • Size: 353.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for marziel-1.0.1.tar.gz
Algorithm Hash digest
SHA256 214e4d1298012e4b936eb7dced566b33b16170868e32709be2e9b8f8ae473171
MD5 db9f72bf04af8c365f62d0a6199ad443
BLAKE2b-256 44da6c8b6606e9ee55022efb28b57ba7fd09cb95c62b441b8cb9e0bd7211a20b

See more details on using hashes here.

File details

Details for the file marziel-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: marziel-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 363.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for marziel-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8e86a310273d4707f67dab7095755cfe569adc556e05b5e022bd41cf5548e782
MD5 fe7afe90151447bf0bcf5817d5f35456
BLAKE2b-256 9010e970142b476abb3433ec4e9805b3b0aff9f1a6c91770a8fa3e616267cd16

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 files

0.9.2

2 files

0.9.1

2 files

0.9.0

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

0.7.0

2 files

0.6.0

2 files

0.5.9

2 files

0.5.8

2 files

0.5.7

2 files

0.5.6

2 files

0.5.5

2 files

0.5.4

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page