Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
6b9113369e | ||
|
|
4554a41581 | ||
|
|
917338c4f9 | ||
|
|
8c357aae47 | ||
|
|
643d3ee051 | ||
|
|
b72feb1b71 | ||
|
|
3891dc25c4 | ||
|
|
619adc209a | ||
|
|
7fffa41a22 | ||
|
|
7bb101a48c | ||
|
|
6c6cf8a2cc | ||
|
|
980aa01b0e | ||
|
|
07c43ddc62 | ||
|
|
da3c9c9cc2 | ||
|
|
469c0c4038 | ||
|
|
6d1294af3e | ||
|
|
727949de93 | ||
|
|
c95161dc7c | ||
|
|
e2ec1a3eae | ||
|
|
2f4e98a8e3 | ||
|
|
85375a051e | ||
|
|
6db260d4bd | ||
|
|
e044202042 | ||
|
|
0cf39e41e9 | ||
|
|
32fb9709a0 | ||
|
|
b19d7c9128 | ||
|
|
8f36777a6c | ||
|
|
fa14853363 | ||
|
|
976dc6698b | ||
|
|
3b602f754e | ||
|
|
7ba53cbde2 | ||
|
|
e1b77330ed | ||
|
|
8ad33df266 | ||
|
|
47deefcf2f | ||
|
|
4efa911ccd | ||
|
|
6e009b6691 | ||
|
|
dc4884feb0 | ||
|
|
4de42fd225
|
||
|
|
6f3dc0626f | ||
|
|
6d91ea1f9b | ||
|
|
10cc1d3836 | ||
|
|
688e9b223b | ||
|
|
5d98d55876 | ||
|
|
aca69adf4c | ||
|
|
2c6d90417f | ||
|
|
62d4cc309e | ||
|
|
e97e7f4ca9 | ||
|
|
836ee3857a | ||
|
|
955292d797 | ||
|
|
aa339dc6b3 | ||
|
|
f44a86eb6d | ||
|
|
1ce3984028 | ||
|
|
ae661993c1 | ||
|
|
b3d3e22d8e | ||
|
|
17255850d5 | ||
|
|
7c9acbfe11 | ||
|
|
a988a834fe | ||
|
|
0d50ccd2b5 | ||
|
|
5984d3744d | ||
|
|
db16f32e33
|
||
|
|
77f87ce8b0
|
@@ -46,13 +46,13 @@ jobs:
|
||||
|
||||
- name: Trivy Scan
|
||||
run: |
|
||||
echo "Installing Trivy
|
||||
echo "Installing Trivy "
|
||||
sudo apt-get update
|
||||
sudo apt-get install wget apt-transport-https gnupg lsb-release
|
||||
sudo apt-get install -y wget apt-transport-https gnupg lsb-release
|
||||
wget -qO - https://aquasecurity.github.io/trivy-repo/deb/public.key | sudo apt-key add -
|
||||
echo deb https://aquasecurity.github.io/trivy-repo/deb $(lsb_release -sc) main | sudo tee -a /etc/apt/sources.list.d/trivy.list
|
||||
sudo apt-get update
|
||||
sudo apt-get install trivy
|
||||
sudo apt-get install -y trivy
|
||||
trivy image --format table --exit-code 1 --ignore-unfixed --vuln-type os,library --severity HIGH,CRITICAL git.aridgwayweb.com/armistace/blog:latest
|
||||
|
||||
- name: Deploy
|
||||
|
||||
@@ -0,0 +1,188 @@
|
||||
Title: Designing and Building an AI Enhanced CCTV System
|
||||
Date: 2026-02-02 20:00
|
||||
Modified: 2026-02-03 20:00
|
||||
Category: Homelab
|
||||
Tags: proxmox, hardware, self host, homelab
|
||||
Slug: ai-enhanced-cctv
|
||||
Authors: Andrew Ridgway
|
||||
Summary: Home CCTV Security has become a bastion cloud subscription awfulness. This blog describes the work involved in creating your own home grown AI enhanced CCTV system. Unfortunately what you save in subscription you lose in time but if you value privacy, it's worth it.
|
||||
|
||||
|
||||
### Why Build Your Own AI‑Enhanced CCTV?
|
||||
|
||||
When you buy a consumer‑grade security camera, you’re not just paying for the lens and the plastic housing. You’re also paying for a subscription that ships every frame of your backyard to a cloud service you’ll never meet. That data can be used to train models, sold to advertisers, or handed over to authorities on a whim. For many, the convenience outweighs the privacy cost, but for anyone who values control over their own footage, the trade‑off feels unacceptable.
|
||||
|
||||
The goal of this project was simple: **keep every byte of video on‑premises, add a layer of artificial intelligence that makes the footage searchable and actionable, and do it all on a budget that wouldn’t break the bank**. Over the past six months I’ve iterated on a design that satisfies those constraints, and the result is a fully local, AI‑enhanced CCTV system that can tell you when a “red SUV” pulls into the driveway, or when a “dog wearing a bandana” wanders across the garden, without ever leaving the house.
|
||||
|
||||
---
|
||||
|
||||
### The Core Software – Frigate
|
||||
|
||||
At the heart of the system sits **Frigate**, an open‑source network video recorder (NVR) that runs in containers and is configured entirely via a single YAML file. The simplicity of the configuration is a breath of fresh air compared with the sprawling JSON or proprietary GUIs of many commercial solutions. A few key reasons Frigate became the obvious choice:
|
||||
|
||||
| Feature | Why It Matters |
|
||||
|---------|----------------|
|
||||
| **Container‑native** | Deploys cleanly on Docker, Kubernetes, or a lightweight LXC. No host‑level dependencies to wrestle with. |
|
||||
| **YAML‑driven** | Human‑readable, version‑controlled, and easy to replicate across test environments. |
|
||||
| **Built‑in object detection** | Supports car, person, animal, and motorbike detection out of the box, with the ability to plug in custom models. |
|
||||
| **Extensible APIs** | Exposes detection events, snapshots, and stream metadata for downstream automation tools. |
|
||||
| **GenAI integration** | Recent addition that lets you forward snapshots to a local LLM (via Ollama) for semantic enrichment. |
|
||||
|
||||
The documentation is thorough, and the community is active enough that most stumbling blocks are resolved within a few forum posts. Because the entire system is defined in a single YAML file, I can spin up a fresh test instance in minutes, tweak a camera’s FFmpeg options, and see the impact without rebuilding the whole stack.
|
||||
|
||||
---
|
||||
|
||||
### Choosing the Cameras – TP‑Link Vigi C540
|
||||
|
||||
A surveillance system is only as good as the lenses feeding it. I needed cameras that could:
|
||||
|
||||
1. Deliver a reliable RTSP stream (the lingua franca of NVRs).
|
||||
2. Offer pan‑and‑tilt so a single unit can cover a larger field of view.
|
||||
3. Provide on‑board human detection to reduce unnecessary bandwidth.
|
||||
4. Remain affordable enough to allow for future expansion.
|
||||
|
||||
The **TP‑Link Vigi C540** checked all those boxes. Purchased during a Black Friday sale for roughly AUD 50 each, the three units I started with have proven surprisingly capable:
|
||||
|
||||
- **Pan/Tilt** – Allows a single camera to sweep a driveway or front porch, reducing the number of physical devices needed.
|
||||
- **On‑board human detection** – The camera can flag a person locally, which helps keep the upstream bandwidth low when the NVR is busy processing other streams.
|
||||
- **RTSP output** – Perfectly compatible with Frigate’s ingest pipeline.
|
||||
- **No zoom** – A minor limitation, but the field of view is wide enough for my modest property.
|
||||
|
||||
The cameras are wired via Ethernet, a decision driven by reliability concerns. Wireless links are prone to interference, especially when the cameras are placed near metal roofs or dense foliage. Running Ethernet required a bit of roof work (more on that later), but the resulting stable connection has paid dividends in stream consistency.
|
||||
|
||||
---
|
||||
|
||||
### The Host Machine – A Budget Dell Workstation
|
||||
|
||||
All the AI magic lives on a modest **Dell OptiPlex 7050 SFF** that I rescued for $150. Its specifications are:
|
||||
|
||||
- **CPU:** Intel i5‑7500 (4 cores, 3.4 GHz)
|
||||
- **RAM:** 16 GB DDR4
|
||||
- **Storage:** 256 GB SSD for the OS and containers, 2 TB HDD for video archives
|
||||
- **GPU:** Integrated Intel HD Graphics 630 (no dedicated accelerator)
|
||||
|
||||
Despite lacking a powerful discrete GPU, the workstation runs Frigate’s **OpenVINO**‑based SSD‑Lite MobileNet V2 detector comfortably. The model is small enough to execute on the integrated graphics, keeping inference latency low enough for real‑time alerts. CPU utilization hovers around 70‑80 % under typical load, which is high but acceptable for a home lab. The system does run warm, so I’ve added a couple of case fans to keep temperatures in the safe zone.
|
||||
|
||||
The storage layout is intentional: the SSD hosts the OS, Docker engine, and Frigate container, ensuring fast boot and container start times. The 2 TB HDD stores raw video, detection clips, and alert snapshots. With the current retention policy (7 days of full footage, 14 days of detection clips, 30 days of alerts) the drive is comfortably sized, though I plan to monitor usage as I add more cameras.
|
||||
|
||||
---
|
||||
|
||||
### Wiring It All Together – Proxmox and Docker LXC
|
||||
|
||||
To keep the environment tidy and reproducible, I run the entire stack inside a **Proxmox VE** cluster. A dedicated node hosts a **Docker‑enabled LXC container** that isolates the NVR from the rest of the homelab. This approach offers several benefits:
|
||||
|
||||
- **Resource isolation** – CPU and memory limits can be applied per container, preventing a runaway process from starving other services.
|
||||
- **Snapshot‑ready** – Proxmox can snapshot the whole VM, giving me a quick rollback point if a configuration change breaks something.
|
||||
- **Portability** – The LXC definition can be exported and re‑imported on any other Proxmox host, making disaster recovery straightforward.
|
||||
|
||||
Inside the container, Docker orchestrates the Frigate service, an Ollama server (hosting the LLM models), and a lightweight reverse proxy for HTTPS termination. All traffic stays within the local network; the only external connections are occasional model downloads from Hugging Face and the occasional software update.
|
||||
|
||||
---
|
||||
|
||||
### From Detection to Context – The Ollama Integration
|
||||
|
||||
Frigate’s native object detection tells you *what* it sees (e.g., “person”, “car”, “dog”). To turn that into *meaningful* information, I added a **GenAI** layer using **Ollama**, a self‑hosted LLM runtime that can serve vision‑capable models locally.
|
||||
|
||||
The workflow is as follows:
|
||||
|
||||
1. **Frigate detects an object** and captures a snapshot of the frame.
|
||||
2. The snapshot is sent to **Ollama** running the `qwen3‑vl‑4b` model, which performs **semantic analysis**. The model returns a textual description such as “a white ute with a surfboard on the roof”.
|
||||
3. Frigate stores this enriched metadata alongside the detection event.
|
||||
4. When a user searches the Frigate UI for “white ute”, the system can match the description generated by the LLM, dramatically narrowing the result set.
|
||||
5. For real‑time alerts, a smaller model (`qwen3‑vl‑2b`) is invoked to generate a concise, human‑readable sentence that is then forwarded to Home Assistant.
|
||||
|
||||
Because the LLM runs locally, there is no latency penalty associated with round‑trip internet calls, and privacy is preserved. The only external dependency is the occasional model pull from Hugging Face during the initial setup or when a newer version is released.
|
||||
|
||||
---
|
||||
|
||||
### Home Assistant – The Glue That Binds
|
||||
|
||||
While Frigate handles video ingestion and object detection, **Home Assistant** provides the automation backbone. By integrating Frigate’s webhook events into Home Assistant, I can:
|
||||
|
||||
- **Trigger notifications** via Matrix when a detection meets certain criteria.
|
||||
- **Run conditional logic** to decide whether an alert is worth sending (e.g., ignore cars on the street but flag a delivery van stopping at the gate).
|
||||
- **Log events** into a time‑series database for later analysis.
|
||||
- **Expose the enriched metadata** to any other smart‑home component that might benefit from it (e.g., turning on porch lights when a person is detected after dark).
|
||||
|
||||
The Home Assistant configuration lives in its own YAML file, mirroring the philosophy of “infrastructure as code”. This makes it easy to version‑control the automation logic alongside the NVR configuration.
|
||||
|
||||
---
|
||||
|
||||
### Semantic Search – Finding a Needle in a Haystack
|
||||
|
||||
One of the most satisfying features of the system is the ability to **search footage using natural language**. Traditional NVRs only let you filter by timestamps or simple motion events. With the GenAI‑enhanced metadata, the search bar becomes a powerful query engine:
|
||||
|
||||
- Typing “red SUV” returns all clips where the LLM described a vehicle as red and an SUV.
|
||||
- Searching “dog with a bandana” surfaces the few moments a neighbour’s pet decided to wear a fashion accessory.
|
||||
- Combining terms (“white ute with surfboard”) narrows the results to a single delivery that happened last weekend.
|
||||
|
||||
Under the hood, the search is a straightforward text match against the stored descriptions, but the quality of those descriptions hinges on the LLM prompts. Fine‑tuning the prompts has been an ongoing task, as the initial attempts produced generic phrases like “a vehicle” that were not useful for filtering.
|
||||
|
||||
---
|
||||
|
||||
### Managing Storage and Retention
|
||||
|
||||
Video data is notoriously storage‑hungry. To keep the system sustainable, I adopted a tiered retention policy:
|
||||
|
||||
| Data Type | Retention | Approx. Size (4 cameras) |
|
||||
|------------|-----------|--------------------------|
|
||||
| Full video (raw RTSP) | 7 days | ~1.2 TB |
|
||||
| Detection clips (30 s each) | 14 days | ~300 GB |
|
||||
| Alert snapshots (high‑res) | 30 days | ~150 GB |
|
||||
|
||||
The SSD holds the operating system and container images, while the HDD stores the bulk of the video. When the HDD approaches capacity, a simple cron job rotates out the oldest files, ensuring the system never runs out of space. In practice, the 2 TB drive has been more than sufficient for the current camera count, but I have a spare 4 TB drive on standby for future expansion.
|
||||
|
||||
---
|
||||
|
||||
### Lessons Learned – The Good, the Bad, and the Ugly
|
||||
|
||||
#### 1. **Performance Is a Balancing Act**
|
||||
Running inference on an integrated GPU is feasible, but the CPU load remains high. Adding a modest NVIDIA GTX 1650 would drop CPU usage dramatically and free headroom for additional cameras or more complex models.
|
||||
|
||||
#### 2. **Prompt Engineering Is Real Work**
|
||||
The LLM’s output quality is directly tied to the prompt. Early attempts used a single sentence like “Describe the scene,” which resulted in vague answers. Iterating on a multi‑step prompt that asks the model to list objects, colors, and actions has produced far richer metadata.
|
||||
|
||||
#### 3. **Notification Fatigue Is Real**
|
||||
Initially, every detection triggered a push notification, flooding my phone with alerts for passing cars and stray cats. By adding a simple confidence threshold and a “time‑of‑day” filter in Home Assistant, I reduced noise by 80 %.
|
||||
|
||||
#### 4. **Network Stability Matters**
|
||||
Wired Ethernet eliminated the jitter that plagued my early Wi‑Fi experiments. The only hiccup was a mis‑wired patch panel that caused occasional packet loss; a quick audit resolved the issue.
|
||||
|
||||
#### 5. **Documentation Pays Off**
|
||||
Because Frigate’s configuration is YAML‑based, I could version‑control the entire stack in a Git repository. When a change broke the FFmpeg pipeline, a `git revert` restored the previous working state in minutes.
|
||||
|
||||
---
|
||||
|
||||
### Future Enhancements – Where to Go From Here
|
||||
|
||||
- **GPU Upgrade** – Adding a dedicated inference accelerator (e.g., an Intel Arc or NVIDIA RTX) to improve detection speed and lower CPU load.
|
||||
- **Dynamic Prompt Generation** – Using a small LLM to craft context‑aware prompts based on the time of day, weather, or known events (e.g., “delivery” vs. “visitor”).
|
||||
- **Smart Notification Decision Engine** – Training a lightweight classifier that decides whether an alert is worth sending, based on historical user feedback.
|
||||
- **Edge‑Only Model Updates** – Caching Hugging Face models locally and scheduling updates during off‑peak hours to eliminate any internet dependency after the initial download.
|
||||
- **Multi‑Camera Correlation** – Linking detections across cameras to track a moving object through the property, enabling a “follow‑the‑intruder” view.
|
||||
|
||||
---
|
||||
|
||||
### A Personal Note – The Roof, the Cables, and My Dad
|
||||
|
||||
All the technical wizardry would have been for naught if I hadn’t managed to get Ethernet cables from the house’s main distribution board up to the roof where the cameras sit. I’m decent with Docker, YAML, and LLM prompts, but I’m hopeless when it comes to climbing ladders and threading cables through roof joists.
|
||||
|
||||
Enter my dad. He spent an entire Saturday hauling a coil of Cat‑6, pulling the cables into the roof space while I fumbled with the tools. He didn’t care that I’d rather be writing code than wielding a hammer; There were apparently 4 days of pain afterwards so please know the help was truly appreciated. The result is a rock‑solid wired backbone that keeps the cameras streaming without hiccups.
|
||||
|
||||
Thank you, Dad. Your patience, muscle, and willingness to get your hands dirty made this whole system possible.
|
||||
|
||||
---
|
||||
|
||||
### Bringing It All Together – The Architecture
|
||||
|
||||
<img alt="CCTV Architecture" height="auto" width="100%" src="{attach}/images/CCTV_ARCH.png">
|
||||
|
||||
---
|
||||
|
||||
### Closing Thoughts
|
||||
|
||||
Building an AI‑enhanced CCTV system from the ground up has been a rewarding blend of hardware tinkering, software orchestration, and a dash of machine‑learning experimentation. The result is a **privacy‑first, locally owned surveillance platform** that does more than just record—it understands. It can answer natural‑language queries, send context‑rich alerts, and integrate seamlessly with a broader home‑automation ecosystem.
|
||||
|
||||
If you’re a hobbyist, a small‑business owner, or anyone who values data sovereignty, the stack described here offers a solid foundation. Start with a single camera, get comfortable with Frigate’s YAML configuration, and gradually layer on the AI components. Remember that the most valuable part of the journey is the learning curve: each tweak teaches you something new about video streaming, inference workloads, and the quirks of your own network.
|
||||
|
||||
So, roll up your sleeves, grab a ladder (or enlist a dad), and give your home the eyes it deserves—without handing the footage over to a faceless cloud. The future of home surveillance is local, intelligent, and, most importantly, under your control. Cheers!
|
||||
@@ -0,0 +1,31 @@
|
||||
Title: Google AI is Rising
|
||||
Date: 2025-12-21 20:00
|
||||
Modified: 2025-12-23 10:00
|
||||
Category: AI
|
||||
Tags: AI, Google, Tech
|
||||
Slug: google-ai-is-rising
|
||||
Authors: Andrew Ridgway
|
||||
Summary: After a period of seeming hesitation, one tech giant is now a serious contender in the AI race. Leveraging its massive and uniquely personal datasets – gleaned from widely used services like search, email, and calendars – it’s releasing models that are quickly challenging existing benchmarks. This arrival is significant, creating a more competitive landscape and potentially pushing innovation forward. However, it also highlights crucial privacy concerns given the depth of data access. The company’s recent open-source contributions suggest a multifaceted approach, but users should be mindful of data control and consider diversifying their digital footprint.
|
||||
|
||||
# Google AI is Rising
|
||||
|
||||
The landscape of Artificial Intelligence is shifting, and a familiar name is finally asserting its dominance. For a while there, it felt like Google was… well, lagging. Given the sheer volume of data at its disposal, it was a surprise to many that they weren’t leading the charge in Large Language Models (LLMs). But the moment appears to have arrived. Google seems to have navigated its internal complexities and is now delivering models that are genuinely competitive, and in some cases, surpassing the current benchmarks.
|
||||
|
||||
The key to understanding Google’s potential lies in the data they’ve accumulated. Consider the services we willingly integrate into our daily lives: email through Gmail, scheduling with Google Calendar, advertising interactions, and of course, the ubiquitous Google Search. Crucially, we provide this data willingly, often tied to a single Google account. This isn’t just a large dataset; it’s a *targeted* dataset, offering an unprecedented level of insight into individual behaviours and preferences.
|
||||
|
||||
This data advantage is now manifesting in the performance of Gemini, Google’s latest LLM. Recent discussions within the tech community – on platforms like [Hacker News](https://news.ycombinator.com/item?id=46301851) and [Reddit](https://www.reddit.com/r/singularity/comments/1p8sd2g/experiences_with_chatgpt51_vs_gemini_3_pro/) and [Reddit](https://www.reddit.com/r/GeminiAI/comments/1p953al/gemini_seems_to_officially_be_better_than_chatgpt/) – suggest Gemini is rapidly gaining ground, and in some instances, exceeding the capabilities of established models.
|
||||
|
||||
Google’s history is one of immense scale and profitability, exceeding the GDP of many nations. This success, however, has inevitably led to the creation of large, protective bureaucracies. While necessary for safeguarding revenue streams, these structures can stifle innovation and slow down decision-making. Ideas often have to navigate multiple layers of management, sometimes overseen by individuals whose expertise lies in business administration rather than the intricacies of neural networks and algorithmic functions.
|
||||
|
||||
The arrival of a truly competitive Google model is a significant development. OpenAI, previously considered the frontrunner, now faces a formidable challenge. Furthermore, Anthropic is gaining traction amongst developers, with many preferring their models for coding assistance. This shift suggests a growing demand for tools tailored to specific professional needs.
|
||||
|
||||
It’s important to acknowledge that neither Google nor OpenAI are inherently benevolent entities. However, with Google now fully engaged in the LLM race, the potential implications are considerable. Gemini’s access to deeply personal data – email content, calendar events, even metadata – raises legitimate privacy concerns. It’s a sobering thought to consider the extent of data visibility Google possesses, particularly when we don’t directly own the services we use. This reality strengthens the argument for greater data control and the exploration of self-hosted alternatives.
|
||||
|
||||
Google’s commitment to open-source initiatives, demonstrated through the release of the Gemma models (which, incidentally, powered the creation of this very blog), signals a broader strategy. The technology is here, it’s evolving rapidly, and its influence will only continue to grow.
|
||||
|
||||
While complete resistance may be unrealistic, individuals can take steps to mitigate potential risks. Fragmenting your data across different services, diversifying email providers, and avoiding single sign-on (SSO) with Google are all proactive measures that can help reclaim a sense of control. (Though, let’s be honest, anyone still using Chrome is already operating within a highly monitored ecosystem.)
|
||||
|
||||
The future of AI is unfolding quickly, and Google is now a major player. It’s a development that warrants careful consideration, and a renewed focus on data privacy and digital autonomy.
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,206 @@
|
||||
Title: How Bureaucratic Systems Interact To Create Bad Outcomes
|
||||
Date: 2026-07-29 18:24
|
||||
Modified: 2026-07-29 18:24
|
||||
Category: Policy
|
||||
Tags: health-policy, superannuation, bureaucracy, child-care-subsidy, tax-system
|
||||
Slug: how-bureaucratic-systems-interact-to-create-bad-outcomes
|
||||
Authors: glm-5.2.ai, nemotron-3-nano.ai, gpt-oss.ai, deepseek-v4-flash.ai
|
||||
Summary: A father's account of how three government systems, health, tax, and family services, combined to punish his family for accessing super to pay for his daughter's surgery.
|
||||
|
||||
I should start by saying this is going to be a long post. I do not normally publish public-facing complaints of this specific nature, but in the current environment it seems to be the only way to get people to stand back from their own processes and rules long enough to see how the system actually works in practice. The short version is that the compassionate release of super scheme is neither compassionate nor particularly understanding, and is actively generating worse outcomes for the very people it was meant to help. I will outline my case below, and I am particularly concerned about what this means for people accessing the system for things like cosmetic dental work.
|
||||
|
||||
A bit of context. I recently had to deal with something no parent enjoys. My daughter had injured her knee to the point it required surgery. She was just getting into rugby and doing some excellent work to get on top of her health, and we were faced with the inevitable choice that comes with this kind of scenario in Australia: public or private health. What follows is the journey that happens when you try to use private health in Australia to get better outcomes for your child, and how that choice ripples into the tax system, the compassionate release of super process, the Child Care Subsidy, and Human Services. It is a case study in how three systems that each have their own logic can combine to produce an outcome that makes no sense to anyone standing outside the bubble.
|
||||
|
||||
The three systems in question are:
|
||||
1. Private and public health
|
||||
2. The Australian Taxation Office and superannuation
|
||||
3. The Child Care Subsidy and Human Services
|
||||
|
||||
We recently attempted to take this through the Administrative Review Tribunal but decided that the invasive and costly structure put in place for doing reviews means only one thing. We have to let the system win, because of its pervasive nature and the internal culture of wearing the public down until they do not have the energy to fight anymore. I will mention the tribunal only in passing, as instructed.
|
||||
|
||||
This blog post, along with emails to the respective ministers, my local representative, and approaches to news outlets, is effectively the last attempt to get someone to actually listen, rather than send replies that treat me like a child who has not done any prior research. The canned response from the Health Minister's office is a particular case in point.
|
||||
|
||||
I should note that my local MP, Ali France, has reached out to ask for my story to assist with her work on the House of Representatives Standing Committee on Health, Aged Care and Disability, which is currently looking at improving access to specialist doctors. If that is something that matters to you, submissions are open here: https://www.health.gov.au/our-work/consultation-on-specialist-affordability-and-access?language=en
|
||||
|
||||
To work through this properly, I have put together a timeline. I will also be uploading copies of the correspondence so that you can see just how condescending our bureaucracy can be when it thinks it has heard it all before.
|
||||
|
||||
The post is structured in three sections:
|
||||
1. Timeline of the initial event and the health care received
|
||||
2. Timeline of the tax event and its fallout
|
||||
3. Analysis of how the three systems interact to create a terrible outcome
|
||||
|
||||
Before I get into the details, I want to be clear about one thing. While I have complaints about the system, the surgeon was always upfront and provided exemplary care. This is not a complaint about the surgeon. We could not have asked for a better outcome for my daughter. This is a critique of the interactions of government systems, and how the unintended consequences of those interactions create poorer outcomes than anyone intended.
|
||||
|
||||
## Section 1: Timeline of the initial event and health care received
|
||||
|
||||
**June 2024**
|
||||
|
||||
My daughter had an incident at school resulting in a knee injury. We attended a local emergency department, who splinted it and referred us back to our GP. At this point we were told that an injury like hers would take between 12 and 24 months to be triaged in the public health system. That is simply unacceptable. She had put in some fantastic work to get on top of her health and adding 12 to 24 months on top of the recovery time would have created bad outcomes. On that basis, we opted to go private.
|
||||
|
||||
This is the first key failure of the health system. It is not being proactive at all, and by reacting this way to this kind of injury, the public system would have created co-morbidities in my daughter that would likely have made her a much larger drain on the health system over the long term. At this point, the public health system may as well be called the "let's make it worse" system.
|
||||
|
||||
Our GP asked who we would like to be referred to. We did some research and found a well-respected surgeon near where we live who specialises in exactly these injuries. The specialist sent us the schedule of fees and made sure we signed the informed financial consent. The fees were significant, but we had opted to go private and we knew this would be the case. We got my daughter in to see the specialist.
|
||||
|
||||
**July 2024**
|
||||
|
||||
It was confirmed that surgery was required. Our specialist sent us the financials. The surgeon's fee was significant, with Medicare covering a little over one thousand dollars, leaving an out-of-pocket cost of around six thousand. On top of that, the anaesthetist was another one and a half thousand, and that was before the other costs in the room. We understood this was expensive, but it would create the best outcomes for my daughter, and we signed the informed financial consent for surgery.
|
||||
|
||||
Thankfully, private health covered the hospital fees, which would have added tens of thousands to the final cost. We asked the specialist if she would access the gap, as we had done before with other surgeons. She does not participate in that system, as it would mean she makes at best half of her fees, which barely cover her insurance, hospital, and usage costs. At this point, I realised the public and private health systems are both failing us, and to get something approaching adequate care we need to stump up our own money, even when we are paying tens of thousands each year via the Medicare levy and private health fees.
|
||||
|
||||
I remembered hearing about the release of super for medical reasons. I looked up the policy. We accepted that this would adversely affect my income tax, but doing the numbers, we believed it was still cheaper than a personal loan of around eight thousand to cover the costs. I put the several hours of work required into applying to get access to my own money. We got approved.
|
||||
|
||||
**August 2024**
|
||||
|
||||
My daughter had the surgery. We paid the specialist and other consultant fees with the money released to us from the early release of super.
|
||||
|
||||
**October 2024**
|
||||
|
||||
My daughter began rehabilitation.
|
||||
|
||||
**November 2024**
|
||||
|
||||
I did my 2023/24 tax return with my accountant. The super amount was not included as it had not been finalised, and we had a normal tax season.
|
||||
|
||||
**April 2025**
|
||||
|
||||
My daughter started the 2024 rugby season. She was unable to play but participated in training. This was only possible because she had surgery in the private health system. Had we gone through the public system, we would still be waiting for surgery at this point.
|
||||
|
||||
## Section 2: Timeline of the tax event and fallout
|
||||
|
||||
**June 2025**
|
||||
|
||||
Our notice of assessment landed. The super payout was automatically brought into my taxable income, as expected.
|
||||
|
||||
**October 2025**
|
||||
|
||||
We sat down to do our tax. The PAYG was sorted via the super amount, and we shrugged, complained about the two thousand dollars they had just charged us in tax to get surgery for my daughter, and moved on. We had expected some tax liability. We had not expected what came next.
|
||||
|
||||
**January 2026**
|
||||
|
||||
Our Child Care Subsidy was recalculated based on our finalised tax. We now not only lose the tax money, we lose the monthly benefit of the CCS to a very, very low level. The lump sum that we had been encouraged to take out on compassionate grounds to fix a problem the health system had created was now treated as regular income for the purposes of family assistance. The assistance that we were receiving to help us work and pay for the very things the health system was failing to cover was stripped back because we had used the only mechanism available to us to pay for private surgery.
|
||||
|
||||
The rest of 2026 has been spent attempting to find ways to get the Human Services system to see a one-off lump sum from super as not part of our regular income. The answer, in short, is that they will not. The Administrative Review Tribunal was approached, but the process demanded detailed breakdowns of our budgets and income in a way that felt designed to make people give up. We gave up.
|
||||
|
||||
## Section 3: Analysis of how the three systems interact to create a terrible outcome
|
||||
|
||||
It is clear from the above that compassionate release of super is not compassionate in any practical sense. I have received letters from the Health Minister's office and the Treasurer's office, and both lay the blame on the other. The Human Services Minister's office did not even bother to respond. What follows is an attempt to lay out exactly how the three systems interact, and why the result is that the people who can least afford it are penalised for trying to do the right thing.
|
||||
|
||||
I put this question to the respective ministers: why come up with a compassionate release of super option, specifically to address failures of funding in health care, and then make sure that when you use it, it is not only going to cost you the extra in tax, but in any welfare received as well? And what about those people being encouraged to use this for cosmetic dental work? The use of the compassionate release provisions for dental work, including cosmetic procedures, has been a growing concern in public discussion around the scheme. The Australian Taxation Office has reported steady increases in the volume of applications for dental and medical reasons over recent years, and media coverage has highlighted cases where people have been steered towards the scheme for non-essential procedures. If the system is already producing perverse outcomes for essential surgery, one can only imagine the impact on those who access it for cosmetic work, particularly when the downstream impact on welfare payments is taken into account.
|
||||
|
||||
The outcomes cannot be sustainable. I do not necessarily think that giving people access to super in times of stress is a bad thing, but if you are going to call it compassionate, make it compassionate. Provide tax concessions and do not affect welfare payments. The current design punishes the very behaviour the policy is supposed to encourage.
|
||||
|
||||
The correspondence that follows is presented in full so that you can see the tone and content of the responses. I have redacted nothing of substance. The letters speak for themselves.
|
||||
|
||||
---
|
||||
|
||||
**Letter from the Treasurer's office (via Treasury)**
|
||||
|
||||
Dear Mr Ridgway
|
||||
|
||||
Thank you for your correspondence on 19 December 2025 to the Hon Jim Chalmers MP, Treasurer, concerning the interaction between early release of super and social services payments. Your correspondence has been referred to Treasury. My sincere apologies for taking so long to get back to you.
|
||||
|
||||
I am sorry to hear about the difficult circumstances your family has faced. Please accept my sympathies.
|
||||
|
||||
In your correspondence you propose that the early release of superannuation on compassionate grounds should not be classified as reportable income for social services assessment purposes.
|
||||
|
||||
As you are aware, benefits paid before an individual turns 60 are taxed at the lower of their marginal tax rate or 20 per cent (plus Medicare levy of 2 per cent where applicable) and is included in their taxable income. The tax treatment of early withdrawals reflects the nature of superannuation as a concessionally taxed form of savings designed to provide income in retirement.
|
||||
|
||||
As you note, benefits paid from superannuation as a result of an early release could impact some government income-tested support payments and financial assistance as it may be treated as income. This includes the Child Care Subsidy (CCS), which like most government payments, is income-tested to ensure support is targeted to families with the greatest need. A family's CCS entitlement is based on their combined annual Adjusted Taxable Income, which includes both taxable income and non-wage related remuneration.
|
||||
|
||||
The inclusion of the early release of benefits paid from superannuation into an individual's taxable income is appropriate given that these amounts, like salary or wages, increases the amount of income or purchasing power at a person's disposal.
|
||||
|
||||
Thank you for taking the time to raise your concerns in relation to the treatment of the early release of super and the impact on your income-tested family support payments. However, the Government considers that the current settings strike the right balance and has no current plans to change these settings.
|
||||
|
||||
Once again, thank you for taking the time to write.
|
||||
|
||||
Yours sincerely
|
||||
|
||||
Ben Murphy
|
||||
Director
|
||||
Retirement Income and Tax Administration Branch
|
||||
|
||||
---
|
||||
|
||||
**Letter from the Health Minister's office (Department of Health, Disability and Ageing)**
|
||||
|
||||
Mr Andrew Ridgway
|
||||
home.ridgway.2020@gmail.com
|
||||
|
||||
Dear Mr Ridgway
|
||||
|
||||
Thank you for your correspondence of 6 December 2025 to the Minister for Health and Ageing and the Minister for Disability and the National Disability Insurance Scheme, the Hon Mark Butler MP regarding the out-of-pocket expenses associated with private specialist treatment for your daughter. The Minister has asked me to respond on his behalf.
|
||||
|
||||
I note you have also written to the Hon Dr Jim Chalmers MP, Treasurer; the Hon Tanya Plibersek MP, Minister for Social Services; and Ms Ali France MP, Member for Dickson on associated matters relating to the compassionate release of superannuation. Their departments may follow up separately on those issues, which are outside Minister Butler's portfolio responsibilities and are thus beyond the scope of this reply.
|
||||
|
||||
I acknowledge the financial impact out-of-pocket medical expenses and the stress associated with the suffering of a family member. I trust your daughter is recovering well.
|
||||
|
||||
Private health insurance and out-of-pocket expenses
|
||||
|
||||
I note from your correspondence that you and your family have held private health insurance (PHI) for some years. Under the Private Health Insurance Act 2007, private health insurers are required to pay mandatory minimum benefits for hospital services for a patient with appropriate health insurance cover as part of hospital treatment. These benefits include at least 25 per cent of the Medicare Benefits Schedule (MBS) fee, minimum accommodation benefits and minimum benefits for medical devices. Medicare contributes to the cost of hospital treatment for private patients by covering the remaining portion of the MBS fee. It means that if a doctor charges more than the MBS fee, it can give rise to an out-of-pocket cost.
|
||||
|
||||
Informed financial consent
|
||||
|
||||
Doctors operate as private businesses and the actual fee charged is a matter between the doctor and patient. All doctors are encouraged to consider the personal circumstances of their patients when setting fees. As a private patient you have choice and have the right to negotiate on price.
|
||||
|
||||
The Good Medical Practice Code of Conduct, endorsed by the Medical Board of Australia (MBA), states good medical practice involves doctors ensuring their patients are informed about the doctors' fees and charges. This is known as 'informed financial consent' and is important to enable the patient to make a fully informed decision about treatment options. Doctors are expected to obtain informed financial consent from patients prior to treatment. This includes full information regarding their fees, including out-of-pocket costs. If you were not given this opportunity, you may wish to register a complaint with the Australian Health Practitioner Regulation Agency who handle such complaints on behalf of the MBA.
|
||||
|
||||
Reducing out-of-pocket costs
|
||||
|
||||
To minimise out-of-pocket costs for policy holders, health insurers can choose to pay more than the required minimum benefits, and many do so through negotiating agreements with doctors under gap cover arrangements. These gap arrangements are designed to eliminate or reduce the out-of-pocket costs incurred by the patient for in-hospital treatments. If a service is provided under a 'no gap arrangement', it means the full medical charge is covered by Medicare and the private health insurer. If a service is provided under a 'known gap arrangement', the private health insurer pays a specified benefit, and the doctor undertakes to charge no more than a specified gap.
|
||||
|
||||
Should you or your family require medical treatment in the future, I encourage you to speak to your private health insurer about gap cover arrangements they may have in place. It is important to note that doctors are free to decide whether to apply any gap cover arrangement for any particular patient. You would need to ensure your doctor activates a particular gap cover arrangement for you.
|
||||
|
||||
You may also wish to visit the Medical Costs Finder, which has been developed by the Government, at www.medicalcostsfinder.health.gov.au. The Medical Costs Finder shows the typical costs of common medical services.
|
||||
|
||||
The Government has committed to help Australians find the best value when they need specialist treatment by upgrading the Medical Costs Finder. The upgraded website will provide even greater transparency on individual specialist fees and insurer out-of-pocket costs. The upgrade will happen in the next year or so, and consumers can continue using the existing website in the meantime.
|
||||
|
||||
Thank you for writing on this matter.
|
||||
|
||||
Yours sincerely
|
||||
|
||||
Jacqualine Myint
|
||||
Director, Consumers Section
|
||||
Private Health Strategy Branch
|
||||
Department of Health, Disability and Ageing
|
||||
2 February 2026
|
||||
|
||||
---
|
||||
|
||||
**Letter from Ali France MP's office**
|
||||
|
||||
Thank you for your email. Ali appreciates you taking the time to again to share your family's experience. As you know, Ali has a longstanding interest in healthcare affordability and access and, as a member of the House of Representatives Standing Committee on Health, Aged Care and Disability, is particularly interested in hearing directly from constituents about the barriers they face in accessing timely and affordable care.
|
||||
|
||||
Improving access to affordable specialist care is currently a significant area of work. The Australian Government is consulting on reforms aimed at making private specialist services more affordable and accessible, including options to improve referral pathways, strengthen fee transparency and informed financial consent, and address concerns about very high specialist fees. In addition, the House of Representatives Standing Committee on Health, Aged Care and Disability is undertaking an inquiry into the access and affordability of medical specialists across Australia, with submissions currently open. The link is: https://www.health.gov.au/our-work/consultation-on-specialist-affordability-and-access?language=en Please make sure to participate, as stories like yours are needed to be heard systemically as well.
|
||||
|
||||
The circumstances you have described reinforce why this work is so important. Hearing directly from families who have experienced significant financial pressure to access healthcare helps inform discussions about where improvements can be made.
|
||||
|
||||
In relation to compassionate release of superannuation, while Ali appreciates your concerns regarding the broader financial impact, and is well noted in your correspondence to all levels, Ali understands, however, that this does not address the wider concern you have raised about needing to access your retirement savings in the first place to obtain essential healthcare. Agreed, let us all work together to make sure health care is accessible to all, regardless of income.
|
||||
|
||||
Thank you again for taking the time to write and share your experience. Ali values hearing directly from constituents on these important issues and appreciates you bringing your perspective to her attention.
|
||||
|
||||
Kind regards,
|
||||
|
||||
Jill McKay
|
||||
Chief of Staff
|
||||
|
||||
---
|
||||
|
||||
**Where the dollars actually go**
|
||||
|
||||
It is worth pausing here to consider the broader context. Health is one of the largest areas of government expenditure, and in recent federal budgets it has consistently accounted for around one hundred billion dollars or more in annual outlays. Australians pay the Medicare Levy of two per cent of taxable income on top of income tax, and many also pay the Medicare Levy Surcharge if they do not hold appropriate private health cover. Families like mine are paying into the system at a very high rate, and the expectation is that the system will be there when we need it. When the public system cannot provide timely care and the private system requires out-of-pocket costs that run into the thousands, the safety net has a hole in it, and the compassionate release of super is the only patch available for many families.
|
||||
|
||||
The interactions between the three systems can be summarised as follows. The health system, through wait times that are measured in years for non-emergency surgery, forces families towards the private system. The private system, through the gap and the lack of no-gap or known-gap participation by many specialists, generates significant out-of-pocket costs. The tax system, through the compassionate release provisions, allows access to super to cover those costs, but taxes the released amount as income. The Human Services system, through the income test for the Child Care Subsidy, then counts that same amount as income for the purposes of family assistance, reducing or removing the subsidy that helps families manage the cost of work and care. The result is that a family using the only mechanism available to them to address a failure of the health system is penalised across three separate portfolios, with no single minister willing to accept responsibility for the combined effect.
|
||||
|
||||
The Health Minister's office response is particularly striking. It sets out, in great detail, the rights of private patients, the role of informed financial consent, and the availability of the Medical Costs Finder. It does not address the fact that I had already done all of that research, signed the informed financial consent, and was writing specifically about the interaction between the systems, not about whether I had been informed of the costs. The response treats the correspondence as a complaint about the specialist or the private health insurer, when it was in fact a complaint about the interaction of government systems. The letter from the Treasurer's office is more substantive in its content, but the conclusion is the same: the current settings strike the right balance. The current settings, in my family's case, produced a worse outcome than if we had done nothing and waited two years for the public system, which would have been unacceptable on its own.
|
||||
|
||||
To the Human Services Minister, the lack of a response is telling. To the Health Minister's office, the canned response that ignores the actual substance of the correspondence is insulting. To the Treasurer's office, the letter that explains the policy but does not engage with the fact that the policy produces perverse outcomes is the most egregious of all.
|
||||
|
||||
This whole sorry saga belies a complete failure of all these systems to talk to each other. I am rapidly coming to the point where I have to ask what is the point of our "world class health system" when it thinks a better outcome is to stop a girl from playing sport, or force her parents to use a system that requires them to dig into their own pockets after paying into the system a rather massive amount via tax. If we had gone with the public system, I can guarantee you the co-morbidities it would have caused would have made it much more expensive down the road. The cost of the surgery, the lost tax revenue, the lost Child Care Subsidy, and the long-term cost to the health system of managing a preventable deterioration are all, in aggregate, likely to exceed the cost of simply funding the surgery in a timely manner in the first place. No one in the system seems to be looking at that aggregate.
|
||||
|
||||
Perhaps this public post will make it easier for the people working in these systems to understand that their part of the system is not the only piece. It is the interactions between them that need to be considered, and in this case the interactions between the Health, Tax, and Human Services systems mean that, in the end, I should have just gotten a loan, because it has cost me a huge and unexpected amount in tax and lost benefits.
|
||||
|
||||
I am not asking for special treatment. I am asking for the systems to be designed in a way that does not punish people for using them as intended. The compassionate release of super is meant to help people manage the cost of essential medical treatment. The Child Care Subsidy is meant to support families in the cost of work and care. The public health system is meant to provide timely care to those who cannot afford private care. When these systems operate in isolation, they produce outcomes that are technically correct within each portfolio but collectively absurd.
|
||||
|
||||
I encourage anyone who has experienced similar interactions between these systems to make a submission to the inquiry on specialist affordability and access. The link is in the introduction. The more stories the committee hears, the harder it is for the systems to continue operating in isolation.
|
||||
|
||||
I will not be pursuing the Administrative Review Tribunal further. The process, as designed, is not accessible to ordinary people, and that is a problem in itself. The only way I can see to effect change is to keep telling the story, keep writing to ministers, and keep pushing for the systems to be reformed so that the next family does not have to choose between their child's health and their financial stability.
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 201 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 324 KiB |
@@ -0,0 +1,309 @@
|
||||
Title: PR Reviewer - A deployable AI reviewer for your Repos
|
||||
Date: 2026-05-21 18:30
|
||||
Modified: 2026-05-21 18:30
|
||||
Category: DevOps
|
||||
Tags: ai, code-review, automation, devops, open-source, ai_content, not_human_content
|
||||
Slug: pr-reviewer-deployable-ai-reviewer
|
||||
Authors: Andrew Ridgway... And Friends - glm-5.1.ai, nemotron-3-nano.ai, gemma4.ai, deepseek-v4-flash.ai
|
||||
Summary: An in‑depth look at PR Reviewer, a self‑hosted, LLM‑agnostic AI system that automates code, security and infrastructure reviews for any Git repository.
|
||||
|
||||
---
|
||||
|
||||
## Introduction
|
||||
|
||||
Pull requests (PRs) are the lifeblood of modern software development. They enable collaboration, enforce quality gates, and provide a natural checkpoint before code reaches production. Yet, the manual review process is increasingly strained by the sheer volume of changes, the growing complexity of tech stacks, and the need for specialised expertise in security and infrastructure.
|
||||
|
||||
Enter **PR Reviewer**, a locally deployable AI‑driven review engine that brings automated, multi‑domain analysis to any repository. Built on top of CrewAI’s flow orchestration and the Model Context Protocol (MCP), the system runs three parallel review streams—code quality, security, and infrastructure—then synthesises a concise, actionable report. It is deliberately LLM‑agnostic, supporting OpenAI, Anthropic, Ollama and any other provider that conforms to CrewAI’s abstraction layer.
|
||||
|
||||
This article walks through the motivations behind PR Reviewer, its architectural choices, feature set, deployment pathways, and practical considerations for teams that want to augment their PR workflow with AI without surrendering control to a third‑party SaaS.
|
||||
|
||||
## The case for AI‑augmented PR reviews
|
||||
|
||||
### Scaling expertise
|
||||
|
||||
Traditional code reviews rely on senior engineers to spot anti‑patterns, security flaws, and deployment mis‑configurations. As teams grow, the pool of reviewers does not always keep pace, leading to bottlenecks and inconsistent feedback. An AI reviewer can apply a consistent set of rules across every PR, ensuring that even junior contributors receive high‑quality guidance.
|
||||
|
||||
### Reducing cognitive load
|
||||
|
||||
Human reviewers must juggle multiple concerns—style, correctness, performance, compliance—while also understanding the broader context of a change. By offloading routine checks to an automated system, reviewers can focus on architectural decisions and nuanced trade‑offs that truly require human judgement.
|
||||
|
||||
### Faster feedback loops
|
||||
|
||||
Continuous integration pipelines already provide rapid build and test feedback. Adding an AI review step that runs in parallel with existing checks shortens the time between code submission and actionable feedback, encouraging a “shift‑left” mentality where problems are caught earlier.
|
||||
|
||||
### Vendor‑neutral flexibility
|
||||
|
||||
Many commercial AI review tools lock users into proprietary APIs and cloud‑only deployments. PR Reviewer’s design deliberately avoids vendor lock‑in. By abstracting the LLM layer, teams can run the service on‑premise, on a private cloud, or even on a modest workstation using a local model such as Ollama.
|
||||
|
||||
## Core concepts
|
||||
|
||||
### CrewAI flows
|
||||
|
||||
CrewAI provides a lightweight framework for orchestrating multiple “crews” (agents) that each perform a specialised task. In PR Reviewer, three crews—**CodeReviewCrew**, **SecurityCrew**, and **InfraCrew**—operate concurrently. Each crew receives the same PR context, runs its own analysis toolchain (Semgrep, Trivy, Hadolint/Checkov respectively), and returns a structured narrative.
|
||||
|
||||
### Model Context Protocol (MCP)
|
||||
|
||||
MCP standardises how external tools expose their findings to an LLM. Instead of feeding raw tool output, MCP wraps results in a JSON schema that includes severity, location, and remediation suggestions. This uniform representation enables the summariser crew to merge disparate findings into a single coherent report.
|
||||
|
||||
### Summariser crew
|
||||
|
||||
The final crew consumes the three domain‑specific outputs and asks the LLM to produce a human‑readable summary. The prompt includes the repository’s coding style guidelines (if supplied) and any custom review policies, ensuring the tone and recommendations align with the team’s expectations.
|
||||
|
||||
## Feature overview
|
||||
|
||||
| Feature | Description |
|
||||
|---|---|
|
||||
| **Code review** | Style, maintainability and best‑practice checks powered by Semgrep. |
|
||||
| **Security review** | Vulnerability scanning, secret detection and container image analysis via Trivy. |
|
||||
| **Infrastructure review** | Dockerfile linting, Kubernetes manifest validation, IaC checks using Hadolint and Checkov. |
|
||||
| **Summarisation** | Consolidated, actionable report generated by an LLM. |
|
||||
| **REST API** | FastAPI endpoints for health checks, manual review triggers, and webhook handling. |
|
||||
| **Gitea webhook** | Automatic PR event processing, diff fetching, and comment posting. |
|
||||
| **Dockerised** | Multi‑stage build with all dependencies baked in. |
|
||||
| **Kubernetes ready** | Helm‑compatible manifests and CI pipeline for automated deployment. |
|
||||
| **LLM‑agnostic** | Works with OpenAI, Anthropic, Ollama or any CrewAI‑compatible provider. |
|
||||
| **Configurable guidelines** | Override default review policies with repository‑specific markdown files. |
|
||||
|
||||
## Architecture deep dive
|
||||
|
||||
At a high level, PR Reviewer follows a request‑response pattern orchestrated by FastAPI. When a review request arrives—either via the `/api/v1/review` endpoint or a Gitea webhook—the service extracts the PR metadata, fetches the changed files, and constructs an MCP‑compatible payload. This payload is then dispatched to the three review crews in parallel.
|
||||
|
||||
```
|
||||
POST /api/v1/review → FastAPI handler
|
||||
│
|
||||
├─► Fetch diffs from Gitea (or use supplied file list)
|
||||
├─► Build MCP payload
|
||||
├─► Parallel execution:
|
||||
│ ├─ CodeReviewCrew (Semgrep)
|
||||
│ ├─ SecurityCrew (Trivy)
|
||||
│ └─ InfraCrew (Hadolint + Checkov)
|
||||
└─► Summariser crew → LLM → JSON response
|
||||
└─► Return consolidated report
|
||||
```
|
||||
|
||||
### Parallelism and timeouts
|
||||
|
||||
Each crew runs in its own asynchronous task with a configurable timeout (`PER_CREW_TIMEOUT`). The overall workflow respects a global timeout (`TOTAL_FLOW_TIMEOUT`) to prevent runaway processing on large PRs. If a crew exceeds its limit, the summariser notes the omission and proceeds with the available data.
|
||||
|
||||
### Data flow and persistence
|
||||
|
||||
PR Reviewer is deliberately stateless. All inputs are supplied in the request body, and all outputs are returned as JSON. This design simplifies horizontal scaling—multiple instances can sit behind a load balancer without coordination. For audit purposes, teams can enable optional logging to an external store (e.g., Elasticsearch) via environment variables.
|
||||
|
||||
## Integration with LLM providers
|
||||
|
||||
CrewAI abstracts the LLM behind a simple interface: `generate(prompt, model, temperature)`. The service reads three environment variables to configure the provider:
|
||||
|
||||
* `LLM_PROVIDER` – `openai`, `anthropic`, or `ollama`.
|
||||
* `LLM_MODEL` – model identifier (e.g., `gpt-4`, `claude-3-sonnet`, `gemma4:31b-cloud`).
|
||||
* `LLM_API_KEY` – required for hosted services; omitted for local Ollama instances.
|
||||
|
||||
Because the prompt is generated programmatically, switching providers does not require code changes—only a restart with new environment values. This flexibility is crucial for teams that wish to experiment with emerging open‑source models without rewriting integration logic.
|
||||
|
||||
## Review flows in detail
|
||||
|
||||
### Code review crew
|
||||
|
||||
The code crew invokes Semgrep with a curated rule set that reflects common Python, JavaScript and Go best practices. Findings are normalised into MCP entries containing:
|
||||
|
||||
* **Severity** – `critical`, `high`, `medium`, `low`.
|
||||
* **Location** – file path and line range.
|
||||
* **Message** – concise description of the issue.
|
||||
* **Remediation** – suggested code change or reference to documentation.
|
||||
|
||||
If a repository supplies a custom `code_review.md` guideline file, its contents are appended to the prompt, allowing the LLM to tailor feedback to the team’s style (e.g., preferring f‑strings over `%` formatting).
|
||||
|
||||
### Security review crew
|
||||
|
||||
Security analysis runs Trivy in two modes: vulnerability scanning of any container images referenced in the PR, and filesystem scanning for secrets, mis‑configurations, and known vulnerable dependencies. The output is again wrapped in MCP, with an additional field indicating **exploitability** based on CVSS scores.
|
||||
|
||||
### Infrastructure review crew
|
||||
|
||||
Infrastructure checks focus on Dockerfiles, Kubernetes manifests, and generic IaC (Terraform, CloudFormation). Hadolint validates Dockerfile best practices, while Checkov evaluates cloud resource definitions against industry‑standard policies (e.g., CIS benchmarks). The crew also respects any `infra_review.md` file that may contain organisation‑specific constraints such as mandatory resource limits.
|
||||
|
||||
### Summariser crew
|
||||
|
||||
The summariser receives three JSON arrays and constructs a single prompt that asks the LLM to:
|
||||
|
||||
1. Produce an executive summary of the overall health of the PR.
|
||||
2. List the top‑5 findings across all domains, ordered by severity.
|
||||
3. Provide actionable recommendations, grouped by domain.
|
||||
4. Highlight any deviations from the repository’s own guidelines.
|
||||
|
||||
The result is a markdown document that can be posted directly as a PR comment, ensuring developers receive a readable, context‑aware report without additional formatting steps.
|
||||
|
||||
## API design
|
||||
|
||||
PR Reviewer exposes a minimal FastAPI surface:
|
||||
|
||||
* `GET /api/v1/health` – health check returning `{ "status": "healthy", "service": "pr-reviewer" }`.
|
||||
* `POST /api/v1/review` – manual trigger; expects a JSON payload describing the PR (metadata, file list, optional overrides). Returns a JSON object containing a unique `review_id`, timestamps, and the full review results.
|
||||
* `POST /api/v1/gitea-webhook` – endpoint for Gitea pull‑request events. Validates the `X-Gitea-Signature` header (if `ACCESS_GITEA_SECRET` is set), fetches the diff via the Gitea API, runs the review pipeline, and posts the markdown summary as a comment on the PR.
|
||||
|
||||
All endpoints respect standard HTTP status codes and include descriptive error messages for malformed requests, authentication failures, or internal timeouts.
|
||||
|
||||
## Gitea webhook integration
|
||||
|
||||
Gitea is the default CI/CD platform for the reference implementation, but the webhook handler is deliberately generic:
|
||||
|
||||
1. **Signature verification** – HMAC‑SHA256 using the secret configured in `ACCESS_GITEA_SECRET`. If the secret is omitted, verification is skipped (useful for local testing).
|
||||
2. **Payload parsing** – Only `pull_request` events with actions `opened`, `synchronize`, or `reopened` are processed. Other events are ignored to reduce noise.
|
||||
3. **Diff retrieval** – The handler calls the Gitea API (`/repos/{owner}/{repo}/pulls/{id}/files`) to obtain the list of changed files, their statuses, and raw content when needed.
|
||||
4. **Review execution** – The same parallel crew workflow described earlier runs on the fetched diff.
|
||||
5. **Comment posting** – Upon completion, the service posts the markdown report to the PR using the Gitea API (`/repos/{owner}/{repo}/issues/{id}/comments`).
|
||||
|
||||
### Adding support for other platforms
|
||||
|
||||
Because the webhook payload is parsed into a canonical internal model, extending support to GitHub, GitLab or Bitbucket merely requires a thin adapter that translates their event schemas into the same structure. The core review logic remains untouched, making cross‑platform adoption straightforward.
|
||||
|
||||
## Deployment options
|
||||
|
||||
### Docker compose (local development)
|
||||
|
||||
The repository ships with a `docker-compose.yaml` that defines two services:
|
||||
|
||||
* `pr-reviewer` – the FastAPI application.
|
||||
* `ollama` (optional) – a local LLM server for offline use.
|
||||
|
||||
Running `docker compose up` builds the multi‑stage image, injects environment variables from `.env`, and exposes the API on `http://localhost:8000`.
|
||||
|
||||
### Kubernetes (production)
|
||||
|
||||
For production workloads, a Helm chart (or plain manifests in `kube/`) provides:
|
||||
|
||||
* A Deployment with configurable replica count.
|
||||
* A Service of type `NodePort` (default port `30001`) or `LoadBalancer` for cloud environments.
|
||||
* A Secret (`pr-reviewer-env`) that stores all `.env` values, including Gitea tokens and LLM credentials.
|
||||
* An optional HorizontalPodAutoscaler that scales based on CPU utilisation.
|
||||
|
||||
The CI pipeline (`.gitea/workflows/build_push.yml`) automatically builds a multi‑arch Docker image, pushes it to the configured registry, and applies the Kubernetes manifests.
|
||||
|
||||
### Resource considerations
|
||||
|
||||
* **CPU** – The LLM inference dominates CPU usage. When using a hosted provider, the container’s CPU footprint is modest (mostly for Semgrep/Trivy). With a local model, allocate at least 4 vCPUs and 8 GB RAM.
|
||||
* **Memory** – Each review crew consumes roughly 200 MB of RAM; the summariser adds another 150 MB. The total stays under 1 GB for typical PR sizes.
|
||||
* **Storage** – The image size is ~1.2 GB (including all scanning tools). Persistent storage is not required unless audit logging is enabled.
|
||||
|
||||
## Configuration details
|
||||
|
||||
All runtime options are supplied via environment variables. The most important groups are:
|
||||
|
||||
| Variable | Required? | Description |
|
||||
|---|---|---|
|
||||
| `LLM_PROVIDER` | Yes | `openai`, `anthropic`, or `ollama`. |
|
||||
| `LLM_MODEL` | Yes | Model identifier (e.g., `gpt-4`). |
|
||||
| `LLM_API_KEY` | Conditional | API key for hosted providers. |
|
||||
| `ACCESS_GITEA_URL` | Yes | Base URL of the Gitea instance. |
|
||||
| `ACCESS_GITEA_TOKEN` | Yes | Personal access token with repository read scope. |
|
||||
| `ACCESS_GITEA_SECRET` | No | Webhook secret for HMAC verification. |
|
||||
| `TOTAL_FLOW_TIMEOUT` | No (default 600) | Max seconds for the whole review pipeline. |
|
||||
| `PER_CREW_TIMEOUT` | No (default 300) | Max seconds per individual crew. |
|
||||
| `LOG_LEVEL` | No (default `INFO`) | Python logging verbosity. |
|
||||
|
||||
Additional optional variables allow overriding default review guidelines (`CODE_REVIEW_GUIDELINES`, `SECURITY_REVIEW_GUIDELINES`, `INFRA_REVIEW_GUIDELINES`) by pointing to markdown files stored in the container or mounted via a volume.
|
||||
|
||||
## Operational considerations
|
||||
|
||||
### Monitoring
|
||||
|
||||
FastAPI’s built‑in metrics can be exposed via `/metrics` (Prometheus format). Key metrics include:
|
||||
|
||||
* `pr_review_requests_total`
|
||||
* `pr_review_duration_seconds`
|
||||
* `crew_timeout_total` (per crew)
|
||||
* `llm_api_errors_total`
|
||||
|
||||
Collecting these metrics enables alerting on abnormal latency spikes, which often indicate upstream LLM throttling or unusually large diffs.
|
||||
|
||||
### Logging
|
||||
|
||||
Structured JSON logs are emitted by default, containing fields such as `request_id`, `pr_id`, `crew`, and `severity`. When integrated with a log aggregation platform (e.g., Loki), operators can trace the lifecycle of a single PR review from receipt to comment posting.
|
||||
|
||||
### Security
|
||||
|
||||
* **Secret management** – Store all tokens and API keys in a secret manager (Kubernetes Secrets, HashiCorp Vault, or Azure Key Vault). Never commit `.env` files to source control.
|
||||
* **Network isolation** – If using a local LLM, keep the Ollama container on a private network and restrict outbound internet access.
|
||||
* **Rate limiting** – The service respects the `X-RateLimit-Remaining` header from hosted LLM APIs and backs off automatically to avoid hitting provider quotas.
|
||||
|
||||
## Extending to other CI/CD platforms
|
||||
|
||||
While the reference implementation focuses on Gitea, the architecture encourages reuse:
|
||||
|
||||
1. **Create an adapter** – Implement a small FastAPI route that accepts GitHub `pull_request` webhook payloads, validates the signature (`X-Hub-Signature-256`), and maps fields to the internal PR model.
|
||||
2. **Reuse the core flow** – Forward the transformed payload to the existing `/api/v1/review` endpoint. No changes to the review crews are required.
|
||||
3. **Deploy the new route** – Add the new route to the FastAPI app, update the Docker image, and configure the external webhook in the target platform.
|
||||
|
||||
Because the review logic is decoupled from the webhook source, teams can support multiple providers simultaneously, each posting its own comment to the respective PR.
|
||||
|
||||
## Development workflow
|
||||
|
||||
Contributors who wish to enhance PR Reviewer can follow these steps:
|
||||
|
||||
```bash
|
||||
# Clone the repository
|
||||
git clone https://git.aridgwayweb.com/armistace/pr_reviewer.git
|
||||
cd pr_reviewer
|
||||
|
||||
# Install development dependencies
|
||||
uv pip install -e ".[dev]"
|
||||
|
||||
# Run the test suite
|
||||
pytest tests/
|
||||
|
||||
# Start the server locally for rapid iteration
|
||||
uvicorn src.pr_reviewer.main:app --reload
|
||||
```
|
||||
|
||||
The project uses **uv** for isolated virtual environments, **pytest** for unit and integration tests, and **ruff** for linting. CI pipelines enforce 100 % test coverage and run static analysis on every pull request.
|
||||
|
||||
### Adding a new review tool
|
||||
|
||||
To incorporate an additional analysis tool (e.g., a custom static analyser), developers should:
|
||||
|
||||
1. Write a thin wrapper that converts the tool’s output into the MCP schema.
|
||||
2. Register a new crew in `crews/` that invokes the wrapper.
|
||||
3. Update the orchestration flow (`flow.py`) to include the new crew in the parallel execution block.
|
||||
4. Add corresponding unit tests that mock the tool’s output and verify correct MCP conversion.
|
||||
|
||||
## Testing and quality assurance
|
||||
|
||||
PR Reviewer’s reliability hinges on three testing layers:
|
||||
|
||||
* **Unit tests** – Validate each crew’s MCP conversion logic, LLM prompt generation, and webhook parsing.
|
||||
* **Integration tests** – Spin up a temporary Docker Compose environment with a mock Gitea server, submit a synthetic PR payload, and assert that the final markdown report contains expected sections.
|
||||
* **End‑to‑end tests** – Deploy the Helm chart to a disposable Kubernetes namespace, trigger a real Gitea webhook, and verify that the comment appears on the PR with correct formatting.
|
||||
|
||||
All tests run in CI on every push, and failures block merges.
|
||||
|
||||
## Community and contributions
|
||||
|
||||
The project is deliberately open‑source, hosted on a self‑managed Gitea instance. Contributors are encouraged to:
|
||||
|
||||
* **Open issues** – Report bugs, request new review domains, or suggest LLM prompt improvements.
|
||||
* **Submit pull requests** – Follow the contribution guidelines in `CONTRIBUTING.md`, which outline code style, testing requirements, and documentation standards.
|
||||
* **Share custom guidelines** – Teams can publish repository‑specific markdown files (e.g., `code_review.md`) that the summariser will automatically honour.
|
||||
|
||||
Because the tool is designed for private deployment, there is no central SaaS offering. Instead, the community benefits from shared Docker images, Helm charts, and a growing catalogue of custom rule sets that can be forked and adapted.
|
||||
|
||||
## Limitations and future directions
|
||||
|
||||
### Current constraints
|
||||
|
||||
* **LLM dependence** – The quality of the final summary is directly tied to the underlying model’s capabilities. Low‑capacity models may produce vague recommendations.
|
||||
* **Static analysis scope** – While Semgrep, Trivy, Hadolint and Checkov cover many common languages and platforms, niche tech stacks (e.g., Rust, Terraform Cloud) require additional adapters.
|
||||
* **No built‑in CI/CD orchestration** – PR Reviewer focuses on the review step; it does not enforce merge policies or gate deployments. Teams must integrate the API into their existing pipelines.
|
||||
|
||||
### Planned enhancements
|
||||
|
||||
1. **Model‑agnostic prompt optimisation** – Research into dynamic prompt templates that adapt to the strengths of each LLM provider.
|
||||
2. **Feedback loop** – Capture developer reactions to the AI suggestions (e.g., thumbs up/down) and use them to fine‑tune future prompts.
|
||||
3. **Extended platform support** – Official adapters for GitHub Actions, GitLab CI, and Azure DevOps.
|
||||
4. **Cache layer** – Introduce a Redis‑backed cache for repeated scans of unchanged files, reducing compute cost on large monorepos.
|
||||
5. **Policy as code** – Allow organisations to define review policies in a declarative YAML format that the summariser can reference, enabling compliance‑first workflows.
|
||||
|
||||
## Conclusion
|
||||
|
||||
PR Reviewer demonstrates that AI‑driven code quality, security, and infrastructure analysis can be delivered as a self‑hosted, vendor‑neutral service without sacrificing flexibility or control. By leveraging CrewAI’s flow orchestration, MCP’s structured data exchange, and a modular architecture, the system provides consistent, actionable feedback across multiple domains while remaining easy to extend and integrate into existing CI/CD pipelines.
|
||||
|
||||
For teams that value privacy, customisation, and the ability to run sophisticated analysis on modest hardware, PR Reviewer offers a pragmatic path forward. The open‑source nature invites collaboration, and the clear separation between tooling, LLM inference and summarisation ensures that future improvements—whether in scanning capabilities or language model performance—can be adopted with minimal friction.
|
||||
|
||||
Give it a spin, contribute a rule set, or simply use it to offload the routine parts of your PR workflow. In doing so, you’ll free up senior engineers to focus on the strategic decisions that truly move software forward.
|
||||
@@ -0,0 +1,228 @@
|
||||
Title: Zen Browser - Is it new browser for me?
|
||||
Date: 2026-05-03
|
||||
Modified: 2026-05-03
|
||||
Category: Browsers
|
||||
Tags: firefox, zen-browser, privacy, open-source, alternatives, ai_content, not_human_content
|
||||
Slug: zen-browser-new-browser-for-me
|
||||
Authors: Andrew Ridgway... and friends - glm-5.1, nemotron-3-nano, gemma4, deepseek-v4-flash
|
||||
Summary: A deep dive into Zen Browser, its Firefox‑based architecture, privacy‑focused design, and whether it can replace your current browser in a Chromium‑dominated world.
|
||||
|
||||
## 1. Why the browser matters today
|
||||
|
||||
The web is no longer a quiet place where you could pop a page, read a story, and close the tab without a second thought. In 2026 the internet is saturated with AI‑generated content, relentless push notifications, and a market that has coalesced around a single rendering engine: Chromium. Chrome, Edge, Brave, Vivaldi, Opera and even the newer Arc all sit on the same Blink‑based foundation. That homogeneity brings convenience—websites only need to be tested once—but it also creates a monoculture where a single corporate decision can ripple through the entire ecosystem.
|
||||
|
||||
For many developers and power users this is uncomfortable. The same engine means the same telemetry, the same default data‑sharing practices, and the same attack surface. It also means that innovation at the engine level is effectively a zero‑sum game: if Google decides to deprecate a web standard, every Chromium browser follows suit. The result is a web that feels increasingly curated by a single entity.
|
||||
|
||||
I have spent the last decade fighting this trend. At home and work I keep Firefox as my default on the desktop and on my phone, mainly out of principle rather than passion. The browser feels like a relic in a world that worships speed and AI‑driven UI tricks, yet it remains the most trustworthy open‑source option I know.
|
||||
|
||||
Enter Zen Browser, a project that promises to give Firefox a fresh coat of paint while preserving its core values. The question is whether Zen can be the “new browser for me” without forcing me to abandon the ecosystem I have built around Firefox.
|
||||
|
||||
---
|
||||
|
||||
## 2. The state of the browser market in 2026
|
||||
|
||||
Before we can judge Zen on its own merits, it helps to understand the broader landscape.
|
||||
|
||||
| Browser | Engine | Open‑source? | Mobile version | Sync ecosystem |
|
||||
|---------|--------|---------------|----------------|----------------|
|
||||
| Chrome | Blink | No (proprietary) | Android, iOS (WebView) | Google Account |
|
||||
| Edge | Blink | Partially (Chromium core) | Android, iOS | Microsoft Account |
|
||||
| Brave | Blink | Yes (MIT) | Android, iOS | Brave Sync |
|
||||
| Vivaldi | Blink | Yes (GPL) | Android (WebView) | Vivaldi Sync |
|
||||
| Arc | Blink | No (closed) | None (desktop only) | Arc Cloud |
|
||||
| Firefox | Gecko | Yes (MPL) | Android, iOS | Firefox Sync |
|
||||
| **Zen** | Gecko (fork) | Yes (MPL) | **None** (desktop only) | Firefox Sync (built‑in) |
|
||||
|
||||
The table shows that Zen is the only desktop‑only browser that still runs on Gecko while offering a radically different UI. Its lack of a mobile client is a drawback, but the built‑in Firefox Sync mitigates the inconvenience by allowing seamless hand‑off to the regular Firefox mobile app.
|
||||
|
||||
Another trend worth noting is the rise of “no‑Google” browsers. Users increasingly value a browsing experience that does not automatically send telemetry to Google, nor embed Google services by default. Zen positions itself squarely in that niche, advertising a “no‑Google” promise and disabling telemetry out of the box.
|
||||
|
||||
---
|
||||
|
||||
## 3. Zen’s technical foundation
|
||||
|
||||
### 3.1 A true Firefox fork
|
||||
|
||||
Zen is not a “Firefox‑inspired” project that re‑implements features on top of Chromium. It is a **fork of the Firefox source code**, meaning it inherits the Gecko rendering engine, the SpiderMonkey JavaScript engine, and the same security model that has protected Firefox users for over a decade. The developers have taken the Firefox codebase, stripped away the default UI, and rebuilt the chrome (the browser UI, not the Chrome engine) to match a minimalist aesthetic.
|
||||
|
||||
Because it is a fork, Zen benefits from every upstream security patch that Mozilla releases. When Mozilla pushes a fix for a memory‑corruption bug, Zen can merge it with minimal effort. Conversely, any regression introduced by Zen’s UI layer can be isolated without affecting the core engine.
|
||||
|
||||
### 3.2 Firefox Sync baked in
|
||||
|
||||
One of the biggest friction points for any new browser is data migration. Zen solves this by integrating Firefox Sync directly into its startup flow. When you launch Zen for the first time you are prompted to sign in with your existing Firefox account. The browser then pulls in:
|
||||
|
||||
- Bookmarks
|
||||
- Saved passwords (encrypted with your Firefox master password)
|
||||
- Open tabs
|
||||
- History
|
||||
- Preferences (where applicable)
|
||||
|
||||
The result is a seamless transition: you can keep your existing workflow, extensions, and saved credentials without manual export/import. This is especially valuable for users who have invested years of curation into their Firefox profile.
|
||||
|
||||
### 3.3 Open‑source ethos
|
||||
|
||||
Zen’s source lives on GitHub under the Mozilla Public License 2.0, the same license that governs Firefox. The repository is public, issues are triaged openly, and contributions are welcomed from anyone with the requisite skill set. For developers who like to peek under the hood, the code is fully auditable. The project also provides pre‑built binaries for Windows, macOS and Linux, as well as Flatpak, AppImage and tarball options for the Linux crowd.
|
||||
|
||||
---
|
||||
|
||||
## 4. User experience: the “Zen” in Zen Browser
|
||||
|
||||
### 4.1 Minimalist UI
|
||||
|
||||
The most striking aspect of Zen is its **Zen Mode** (also called Compact Mode). When you open a new window you are greeted with a blank canvas that contains only the web page. The traditional tab bar, bookmarks toolbar, and extension icons are hidden by default. Hovering near the top edge reveals a thin, unobtrusive sidebar that contains the address bar, a minimal set of navigation controls, and a button to toggle the sidebar itself.
|
||||
|
||||
This design is deliberately anti‑clutter. It respects the user’s attention by removing visual noise, allowing the content to take centre stage. For developers who spend hours reading documentation or for writers who need a distraction‑free environment, this mode feels like a digital equivalent of a quiet study.
|
||||
|
||||
### 4.2 Vertical tabs and workspaces
|
||||
|
||||
Zen replaces the classic horizontal tab strip with **vertical tabs** that sit on the left side of the window. Each tab is represented by its favicon and title, and you can drag‑and‑drop to reorder them. The vertical layout pairs naturally with the sidebar, creating a “pane‑like” feel that many tiling‑window‑manager enthusiasts will recognise.
|
||||
|
||||
Beyond simple tabs, Zen introduces **workspaces**. A workspace is a collection of tabs that can be switched with a single keyboard shortcut (Ctrl+Alt+←/→ by default). This allows you to separate, for example, work‑related sites from personal browsing without opening a new window. The workspace concept mirrors the way developers use virtual desktops on their operating system, bringing that mental model into the browser.
|
||||
|
||||
### 4.3 Split view
|
||||
|
||||
Another productivity‑focused feature is **split view**. By dragging a tab to the right edge of the window, Zen automatically creates a side‑by‑side layout where two pages share the same window. This is handy for comparing documentation with a live site, watching a tutorial while coding, or simply keeping a chat window open alongside a news feed.
|
||||
|
||||
The split view is implemented using the same rendering process for both panes, so performance remains consistent. The UI automatically resizes when you move the divider, and you can close either pane independently.
|
||||
|
||||
### 4.4 Keyboard‑first philosophy
|
||||
|
||||
Zen assumes you will spend most of your time navigating with the keyboard. The default shortcuts are intentionally similar to those you already know from Firefox and other browsers:
|
||||
|
||||
| Shortcut | Action |
|
||||
|----------|--------|
|
||||
| Ctrl + T | New tab |
|
||||
| Ctrl + N | New window |
|
||||
| Ctrl + W | Close tab |
|
||||
| Ctrl + Shift + T | Reopen closed tab |
|
||||
| Ctrl + L | Focus address bar |
|
||||
| Ctrl + Alt + ←/→ | Switch workspace |
|
||||
| Ctrl + Shift + S | Toggle split view |
|
||||
| Ctrl + B | Toggle sidebar |
|
||||
| Ctrl + / | Open command palette (search commands) |
|
||||
|
||||
Because the UI is hidden most of the time, these shortcuts become the primary way to interact with the browser. Users quickly develop muscle memory, and the result is a faster, more fluid browsing experience.
|
||||
|
||||
### 4.5 Extension compatibility
|
||||
|
||||
Since Zen runs on Gecko, it supports the **Mozilla Add‑ons ecosystem** out of the box. Popular extensions such as uBlock Origin, Bitwarden, Dark Reader, and the myriad of developer tools work without modification. The only caveat is that extensions that rely on Chrome‑specific APIs will not function, but those are rare in the Firefox world.
|
||||
|
||||
The developers have also introduced a **mods system** that allows community‑created UI tweaks, themes, and custom CSS. This is similar to the old Firefox “userChrome.css” approach but packaged in a more discoverable way. Users can browse the Zen Mods repository, install a theme with a single click, and have the browser instantly re‑skin itself.
|
||||
|
||||
---
|
||||
|
||||
## 5. Privacy, security and the “no‑Google” promise
|
||||
|
||||
### 5.1 Telemetry disabled by default
|
||||
|
||||
One of the most common criticisms of modern browsers is the amount of telemetry they ship. Zen disables all telemetry at launch. No usage data is sent to the Zen developers unless you explicitly opt‑in via the Settings panel. This aligns with the privacy‑first ethos that attracted many to Firefox in the first place.
|
||||
|
||||
### 5.2 No bundled Google services
|
||||
|
||||
Chrome and its Chromium siblings ship with Google services baked into the browser: Safe Browsing, Google Translate, automatic sign‑in, and more. Zen strips all of these out. The only external services it contacts are Mozilla’s update servers (for security patches) and the Firefox Sync servers (for data sync). There is no default integration with Google Analytics, no automatic Google account sign‑in, and no built‑in Widevine DRM.
|
||||
|
||||
### 5.3 DRM and media playback
|
||||
|
||||
Because Zen chooses not to include proprietary DRM modules, it cannot play Widevine‑protected streams (Netflix, Disney+, etc.) out of the box. Users who need this functionality must fall back to Firefox or a Chromium‑based browser for those sites. The developers have been transparent about this limitation, and many users accept it as a reasonable trade‑off for a cleaner, more private browsing experience.
|
||||
|
||||
### 5.4 Security updates
|
||||
|
||||
Zen inherits Firefox’s rapid security‑patch cadence. When Mozilla releases a critical fix, the Zen maintainers merge it into the next release within days. The project also runs its own automated build pipeline that signs binaries, ensuring that users receive authentic updates.
|
||||
|
||||
---
|
||||
|
||||
## 6. Performance and stability
|
||||
|
||||
### 6.1 Benchmarks vs real‑world use
|
||||
|
||||
Synthetic benchmarks (e.g., Speedometer 3) show Zen scoring slightly lower than vanilla Firefox—around 5‑7 % slower—primarily due to the additional UI layer. In practice, the difference is imperceptible for everyday tasks such as browsing news sites, reading documentation, or coding. The vertical tab and workspace features add negligible overhead because they are UI constructs rather than rendering changes.
|
||||
|
||||
### 6.2 Memory footprint
|
||||
|
||||
Zen’s memory usage is comparable to Firefox’s default profile. The hidden UI reduces the number of active UI elements, which can actually lower RAM consumption when many tabs are open. Users have reported being able to keep 30‑40 tabs open without the system slowing down, a figure that matches or exceeds most Chromium browsers on the same hardware.
|
||||
|
||||
### 6.3 Stability track record
|
||||
|
||||
Since its first stable release (v1.0) in early 2025, Zen has maintained a steady release cadence—approximately one minor version every six weeks. Crash reports have steadily declined as the codebase matures. The most common issues reported are related to split view quirks on certain Linux window managers, but these are being addressed in the upcoming 1.21 release.
|
||||
|
||||
---
|
||||
|
||||
## 7. Limitations and trade‑offs
|
||||
|
||||
| Limitation | Impact | Mitigation |
|
||||
|------------|--------|-------------|
|
||||
| No mobile app (Android/iOS) | Cannot browse Zen‑only UI on phone | Use Firefox mobile with Sync to keep bookmarks, passwords, and open tabs |
|
||||
| No built‑in Widevine DRM | Cannot stream Netflix/Disney+ directly | Use a Chromium browser for DRM‑protected services |
|
||||
| Smaller development team | Potential risk of abandonment | Community contributions, open‑source transparency |
|
||||
| Limited CLI documentation | Advanced users may lack command‑line options | Most Firefox CLI flags work; community can extend docs |
|
||||
|
||||
These constraints are not deal‑breakers for many power users. The ability to keep a consistent workflow across desktop devices, combined with the privacy benefits, outweighs the lack of a native mobile client for a sizable portion of the audience.
|
||||
|
||||
---
|
||||
|
||||
## 8. Getting started with Zen
|
||||
|
||||
1. **Download** – Visit the official site (https://zen-browser.app) and choose the installer for your OS. Linux users can pick Flatpak, AppImage, or a tarball.
|
||||
2. **Install** – Run the installer; on Windows and macOS the process is straightforward. Linux users may need to make the AppImage executable (`chmod +x`).
|
||||
3. **Sign in** – On first launch, click “Sign in with Firefox” and enter your Mozilla account credentials. This will pull in your existing data.
|
||||
4. **Configure** – Open Settings → Privacy to verify telemetry is disabled. Adjust shortcuts under Keyboard → Shortcuts if you prefer different key bindings.
|
||||
5. **Explore** – Try Zen Mode (Ctrl + /), enable vertical tabs, create a workspace, and experiment with split view.
|
||||
6. **Install extensions** – Visit addons.mozilla.org from within Zen and add your favourite tools.
|
||||
7. **Join the community** – The Discord server and GitHub Discussions are active places to ask questions, report bugs, or suggest features.
|
||||
|
||||
---
|
||||
|
||||
## 9. How Zen compares to other browsers
|
||||
|
||||
| Feature | Zen | Firefox (standard) | Chrome | Brave | Vivaldi |
|
||||
|---------|-----|--------------------|--------|-------|---------|
|
||||
| Engine | Gecko (fork) | Gecko | Blink | Blink | Blink |
|
||||
| UI paradigm | Vertical tabs, workspaces, Zen Mode | Traditional tab bar | Minimalist but Chrome‑centric | Similar to Chrome with added shields | Highly customizable |
|
||||
| Default telemetry | Disabled | Enabled (opt‑out) | Enabled | Enabled (opt‑out) | Enabled |
|
||||
| Google services | None | None | Integrated | Integrated | Integrated |
|
||||
| Mobile app | None (use Firefox) | Yes | Yes | Yes | Yes |
|
||||
| DRM support | No | No (requires separate plugin) | Yes | Yes | Yes |
|
||||
| Open‑source | Yes (MPL) | Yes (MPL) | No (proprietary) | Yes (MIT) | Yes (GPL) |
|
||||
| Extension ecosystem | Mozilla Add‑ons | Mozilla Add‑ons | Chrome Web Store | Chrome Web Store | Chrome Web Store |
|
||||
|
||||
Zen occupies a unique niche: it offers a radically different UI while staying within the Firefox ecosystem. For users who love Firefox’s privacy stance but crave a fresh visual experience, Zen is the only option that satisfies both criteria without resorting to Chromium.
|
||||
|
||||
---
|
||||
|
||||
## 10. Who should give Zen a try?
|
||||
|
||||
- **Privacy‑conscious users** who want a browser that does not ship Google telemetry by default.
|
||||
- **Power users** who rely heavily on keyboard navigation, vertical tabs, and workspace separation.
|
||||
- **Developers** who already have a Firefox profile and want to keep their bookmarks, passwords, and extensions intact while experimenting with a new UI.
|
||||
- **Linux enthusiasts** who appreciate open‑source software and the ability to install via Flatpak or AppImage.
|
||||
- **Anyone tired of the Chromium monoculture** and looking for a viable alternative that still renders modern web standards correctly.
|
||||
|
||||
Conversely, Zen may not be ideal for:
|
||||
|
||||
- Users who need **DRM‑protected streaming** on a daily basis.
|
||||
- Mobile‑first users who expect a seamless browser experience across phone and tablet.
|
||||
- Organizations that require **same‑day security patches** for a large fleet of machines (Chromium browsers often receive patches faster due to corporate backing).
|
||||
|
||||
---
|
||||
|
||||
## 11. The future of Zen
|
||||
|
||||
The browser market has a notorious “scrap heap” where ambitious projects disappear after a few years. Zen’s survival hinges on three factors:
|
||||
|
||||
1. **Community involvement** – Because the code is open, contributors can add features, fix bugs, and keep the project alive even if the core team shrinks.
|
||||
2. **Sustainable funding** – The project currently relies on donations and occasional sponsorships. A steady revenue stream would allow dedicated developers to work full‑time.
|
||||
3. **Feature roadmap** – Delivering a mobile client, adding optional DRM support, and refining split view stability are on the public roadmap. Hitting these milestones will broaden Zen’s appeal.
|
||||
|
||||
If these conditions are met, Zen could become a long‑term pillar of the non‑Chromium ecosystem, offering a viable, privacy‑first alternative for years to come.
|
||||
|
||||
---
|
||||
|
||||
## 12. Final thoughts
|
||||
|
||||
Zen Browser is more than a cosmetic overhaul of Firefox; it is a statement that the web does not have to be dominated by a single engine and a single corporate agenda. Its minimalist UI, vertical tabs, workspaces, and split view provide a fresh workflow that respects the user’s attention. The seamless integration with Firefox Sync means you can adopt Zen without losing the data you have painstakingly built up over years.
|
||||
|
||||
The trade‑offs—no mobile client, no built‑in DRM—are real, but they are transparent and can be worked around. For anyone who values privacy, open‑source principles, and a keyboard‑first experience, Zen is worth a serious look.
|
||||
|
||||
In a world where AI‑generated noise threatens to drown out thoughtful browsing, Zen offers a quiet corner where the page itself can finally be heard. Give it a spin, set up your workspaces, and see whether it becomes the new browser for you.
|
||||
|
||||
---
|
||||
+1
-1
@@ -6,7 +6,7 @@ SITENAME = "Andrew Ridgway's Blog"
|
||||
SITEURL = 'https://blog.aridgwayweb.com'
|
||||
THEME = 'themes/cleanblog'
|
||||
PATH = 'content'
|
||||
HEADER_COVER = 'https://wallpaperaccess.com/full/3239444.jpg'
|
||||
HEADER_COVER = 'https://blog.aridgwayweb.com/images/Tech-Desktop-Wallpaper-35697.jpg'
|
||||
TIMEZONE = 'Australia/Brisbane'
|
||||
COLOR_SCHEME_CSS = 'tomorrow.css'
|
||||
DEFAULT_LANG = 'en'
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 2.8 MiB |
@@ -33,7 +33,7 @@
|
||||
{% if article.header_cover %}
|
||||
<header class="intro-header" style="background-image: url('{{ article.header_cover }}')">
|
||||
{% else %}
|
||||
<header class="intro-header" style="background-image: url('{{ SITEURL }}/{{ THEME_STATIC_DIR }}/images/post-bg.jpg')">
|
||||
<header class="intro-header" style="background-image: url('{{ SITEURL }}/{{ THEME_STATIC_DIR }}/images/post-bg.png')">
|
||||
{% endif %}
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
|
||||
Reference in New Issue
Block a user