Skip to content

tl;dr

Overview

fault comes with the following main capabilities in one CLI.

  • Fault Injection: operation oriented features
  • AI Agent: LLM-based features
  • Easy platform injection
---
config:
  theme: 'forest'
---
mindmap
  root((fault CLI))
    Fault Injection
      Proxy
        Network
        LLM
        Database
        DNS
      Scenario
    AI Agent
      Review
        Code
        Scenario
        Platform
      MCP Server
    Platform
      Kubernetes
      AWS
      GCP

Getting started with fault injection

The core of fault is its fault injection engine. It allows you to:

  • Inject faults into your services

    Run fault run to start injecting network failures

  • Automate these failures into YAML files that can be run from your CI

    Run fault scenario generate and fault scenario run to create YAML-based scenarios that can be stored alongside your code and executed from your CI.

Getting started with fault injection for LLM

The core of fault is its fault injection engine. It offers a nice way to inject LLM-specific faults into your your LLM calls:

  • Inject faults into your services making calls to LLM providers

    Run fault run llm to start injecting LLM faults

Getting started with fault injection for DNS

The core of fault is its fault injection engine. It offers a nice way to inject DNS-specific faults into your your network:

  • Inject DNS faults

    Run fault run dns to start injecting DNS faults

Getting started with platform injection

fault makes it easy to inject itself into your platform so you can easily explore faults there as well.

  • Inject faults into your favourite platform

    Run fault inject to start injecting faults

Getting started with the AI Agent

If you are keen to get started with the AI-agent, the general steps are as follows:

  • Pick up your favorite LLM

    fault supports OpenAI, Gemini, OpenRouter and ollama. If you use any of the cloud-based LLMs, you will need to generate an API key. If you want privacy, go with ollama.

  • Configure your AI-Code editor

    Setup the editor of your choice so it knows how to find fault as a MCP server. Most of the time it's by adding a mcpServers object somewhere in their settings file.

Next Steps

  • Start exploring our tutorials to gently get into using fault.
  • Explore our How-To guides to explore fault's features.