{"slug": "release-of-monvisoer-0-1-0", "title": "Release of MonVisoer 0.1.0", "summary": "MonVisor 0.1.0, an AI-augmented tool for generating Prometheus, Alertmanager, and Grafana monitoring configurations, has been released. The free-tier CLI scans a network, fingerprints services, and uses a local RAG knowledge base with an Ollama model to produce monitoring YAML files, with all processing occurring locally and no data leaving the host. The deploy and Grafana automation features remain in the paid tier and are not yet implemented.", "body_md": "**AI-augmented monitoring configuration for Prometheus, Alertmanager, and Grafana.**\n\nMonVisor scans a network, fingerprints the services it finds, lets you approve what to monitor, and generates Prometheus/Alertmanager/rules YAML — using a local RAG knowledge base and a local Ollama model. Everything runs locally; no data leaves the host and there is no API cost.\n\nStatus: free-tier CLI is functional (discovery → review → generate → reports, plus an optional web review UI and nginx config). Deploy/Grafana automation is the paid tier and not yet implemented.\n\nLatest release:[v0.1.0]·[all releases]\n\n```\nscan  ──▶  review  ──▶  generate  ──▶  (deploy: paid)\n │           │             │\n nmap     yes/no per     RAG + Ollama draft rules.yml;\n + HTTP   service        deterministic prometheus.yml\n probe\n```\n\n- Python 3.11+\n[nmap](https://nmap.org/)on`PATH`\n\n(service discovery)`curl`\n\nand`zstd`\n\n(needed to install Ollama)[Ollama](https://ollama.com/)running locally, with:- an LLM (default\n`gemma4:latest`\n\n) - the embedding model\n`nomic-embed-text:latest`\n\n- an LLM (default\n- ~12–15 GB free disk for the models\n`promtool`\n\n(optional) for config validation\n\n**Latest release: v0.1.0** —\ndownload\n\n`monvisor-0.1.0-install.tar.gz`\n\nfrom the\n[releases page](https://github.com/linuxrebel/MonVisor/releases), then:\n\n```\ntar xzf monvisor-0.1.0-install.tar.gz\ncd monvisor-0.1.0-install\npython3 install.py\n```\n\nThe tarball bundles the installer, the wheel, this guide, and the license — no clone or further downloads needed. The rest of this section covers installing from a clone or by hand.\n\nThe fastest path is the bundled installer. It checks and installs the system prerequisites (nmap, curl, zstd, python venv), installs and starts Ollama and pulls the models, creates a virtualenv, installs MonVisor, and runs first-time setup — all in one go:\n\n```\npython3 scripts/install.py\n```\n\nIt installs MonVisor from the published GitHub release wheel when available. If there is no release yet (or you're working from a clone), build the wheel first so the installer has something local to fall back to:\n\n```\npip install build           # one-time, if not already present\npython3 -m build            # creates dist/monvisor-*.whl\npython3 scripts/install.py  # finds and installs the local dist/ wheel\n```\n\nFlags: `--no-sudo`\n\n(skip system packages), `--no-models`\n\n(skip pulling Ollama\nmodels), `--no-init`\n\n(install only), `--install-ollama`\n\n/ `--no-install-ollama`\n\n(control the Ollama install prompt), `--venv PATH`\n\n, `--wheel PATH`\n\n.\n\nTo do everything by hand instead, follow the four steps below. For a fuller\nwalkthrough (every prerequisite, plus troubleshooting), see [INSTALL.md](/linuxrebel/MonVisor/blob/main/INSTALL.md).\n\nMonVisor is a Python package. The full install is three parts: system tools, a running Ollama with two models, then the package itself.\n\n```\n# Fedora / RHEL\nsudo dnf install python3 python3-pip nmap curl zstd\n\n# Debian / Ubuntu\nsudo apt install python3 python3-pip python3-venv nmap curl zstd\n```\n\n`nmap`\n\nmust be on your `PATH`\n\n(scanning depends on it). `curl`\n\nand `zstd`\n\nare\nneeded to install Ollama in the next step — the Ollama installer is\nzstd-compressed and fails without it. Python 3.11+ is required.\n\n`init`\n\n, `ask`\n\n, and `generate`\n\nall use a local Ollama instance, and `init`\n\nbuilds embeddings from the bundled knowledge, so the models must be pulled\n*before* you initialize.\n\n```\n# install Ollama: https://ollama.com/download  (or: curl -fsSL https://ollama.com/install.sh | sh)\nollama serve &                 # start the server if it isn't already running\n\nollama pull gemma4             # the LLM (default model)\nollama pull nomic-embed-text   # the embedding model — REQUIRED, init fails without it\n```\n\nOllama listens on `http://localhost:11434`\n\nby default. Point MonVisor elsewhere\nwith `MONVISOR_OLLAMA_URL`\n\nor `monvisor config set ollama-url <url>`\n\n.\n\nUse a virtual environment to keep dependencies isolated:\n\n```\npython3 -m venv ~/.venvs/monvisor\nsource ~/.venvs/monvisor/bin/activate\n\n# from a release wheel (recommended)\npip install monvisor-0.1.0-py3-none-any.whl\n\n# or from the sdist\npip install monvisor-0.1.0.tar.gz\n\n# or from a source clone\npip install .\n\n# or editable, for development\npip install -e .\n```\n\nThis installs the `monvisor`\n\ncommand. The knowledge base (RAG corpus + reference\nconfigs) ships *inside* the package, so there is nothing else to download —\n`monvisor init`\n\nis fully self-contained. (Developers can override the corpus\nwith `MONVISOR_CORPUS`\n\n/ `MONVISOR_EXEMPLARS`\n\n.)\n\n```\nmonvisor init\n```\n\nThis creates `~/.monvisor/`\n\n(database, vector store, reports, configs), loads\nthe bundled knowledge into the RAG store (embedding takes a minute), and sets a\npassword for the web UI. Re-running `init`\n\ncleanly reloads the knowledge;\n`monvisor init --reset-knowledge`\n\nforces a fresh rebuild.\n\nVerify it worked:\n\n```\nmonvisor knowledge status       # should report 231 pairs loaded\nmonvisor ask \"How do I run a scan?\"\n```\n\nTo leave the activated environment, run `deactivate`\n\n(or just close the\nterminal).\n\nTo run `monvisor`\n\nfrom any shell without activating the venv each time, add an\nalias to `~/.bashrc`\n\n(or `~/.zshrc`\n\n):\n\n```\nalias monvisor=\"$HOME/.venvs/monvisor/bin/monvisor\"\n```\n\nThis is preferable to auto-activating the venv on login, which would also change\nwhich `python`\n\n/`pip`\n\nthe rest of your shell uses. See [INSTALL.md](/linuxrebel/MonVisor/blob/main/INSTALL.md)\nfor details.\n\nAfter `monvisor init`\n\n(see Install above):\n\n```\nmonvisor env add prod 192.168.1.0/24   # register a network as 'prod'\nmonvisor scan prod                     # discover + fingerprint services\nmonvisor review prod                   # approve services to monitor (y/b/n/s/a/q)\nmonvisor generate prod                 # build prometheus.yml + rules.yml\nmonvisor ui prod                       # optional web review UI (localhost:7373)\nmonvisor nginx prod                    # optional reverse-proxy config\n```\n\nOutputs are written under `~/.monvisor/`\n\n(`reports/`\n\n, `configs/`\n\n).\n\nMonVisor has a built-in assistant that answers from its local knowledge base — both how to use MonVisor and Prometheus/Alertmanager/Grafana questions:\n\n```\nmonvisor ask \"How do I run a scan?\"\nmonvisor ask \"show me a node_exporter scrape config\"\nmonvisor ask \"How do I report a bug?\"\n```\n\nAnswers come only from the bundled knowledge (no internet). If a question isn't\ncovered, MonVisor says so and points you to the issue tracker rather than\nguessing. Add `--show-sources`\n\nto see which knowledge snippets were used.\n\n| Env var | Purpose | Default |\n|---|---|---|\n`MONVISOR_HOME` |\nData directory | `~/.monvisor` |\n`MONVISOR_OLLAMA_URL` |\nOllama endpoint | `http://localhost:11434` |\n`MONVISOR_PORT` |\nWeb UI port | `7373` |\n`MONVISOR_CORPUS` |\nOverride RAG corpus path (dev) | bundled |\n`MONVISOR_EXEMPLARS` |\nOverride exemplar dir (dev) | bundled |\n\n**Free (CLI):** CIDR scan + fingerprinting, terminal + HTML reports, web review UI,\nPrometheus/Alertmanager/rules generation, blackbox fallback for un-instrumentable\nhosts, exporter recommendations, RAG knowledge updates.\n\n**Professional (planned):** SSH config deploy, Grafana dashboard provisioning,\nAI-generated dashboards, Grafana-native review UI, enterprise auth (LDAP, Duo,\nAWS IAM, SAML).\n\n```\npip install -e .\npython -m build        # build sdist + wheel into dist/\n```\n\nMonVisor (the application) is licensed under the GNU General Public License\nv3.0 or later (GPL-3.0-or-later) — see [LICENSE](/linuxrebel/MonVisor/blob/main/LICENSE).\n\nThe bundled knowledge base (`monvisor/knowledge/`\n\n) comes from the separate\n[MonVisor-Corpus](https://github.com/linuxrebel/MonVisor-Corpus) project and is\nlicensed CC BY-SA 4.0. The two licenses apply to their respective parts.", "url": "https://wpnews.pro/news/release-of-monvisoer-0-1-0", "canonical_source": "https://github.com/linuxrebel/MonVisor", "published_at": "2026-06-02 23:28:44+00:00", "updated_at": "2026-06-02 23:46:20.895897+00:00", "lang": "en", "topics": ["ai-tools", "ai-products", "ai-infrastructure", "large-language-models", "mlops"], "entities": ["MonVisoer", "Prometheus", "Alertmanager", "Grafana", "Ollama", "nmap", "gemma4", "nomic-embed-text"], "alternates": {"html": "https://wpnews.pro/news/release-of-monvisoer-0-1-0", "markdown": "https://wpnews.pro/news/release-of-monvisoer-0-1-0.md", "text": "https://wpnews.pro/news/release-of-monvisoer-0-1-0.txt", "jsonld": "https://wpnews.pro/news/release-of-monvisoer-0-1-0.jsonld"}}