explaingit

panda1847/oracle-mission-control

Analysis updated 2026-05-18

2PythonAudience · ops devopsComplexity · 4/5LicenseSetup · moderate

TLDR

A deterministic mission-planning tool for authorized security testing that keeps a rule-based planner, not an AI, in control of every action.

Mindmap

mindmap
  root((repo))
    What it does
      Plans security tests
      Checks scope first
      Grades risk
      Records findings
    Tech stack
      Python
      Go
      Ollama
    Use cases
      Authorized network testing
      Compliance reporting
      Audit log replay
    Audience
      Security testers
      Compliance teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run authorized security tests against a defined network scope with built in guardrails.

USE CASE 2

Track hosts, services, and findings in a structured evidence record during a test.

USE CASE 3

Require manual approval before higher risk testing actions run.

USE CASE 4

Generate reports summarizing a completed security test for a client or compliance team.

What is it built with?

PythonGoOllama

How does it compare?

panda1847/oracle-mission-control0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity4/52/52/5
Audienceops devopsgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Python and Go installed, optional Ollama for free local AI.

In plain English

ORACLE is a mission orchestration tool built for people who run authorized security testing, the kind of testing where you have explicit permission to probe a computer network for weaknesses. Instead of letting an AI decide what happens during a test, ORACLE uses a plain, predictable state machine, called a deterministic planner, to decide the next step. An AI can suggest an action, but it cannot take one outside of what the planner already allows, and if the AI fails, the planner keeps going without it. Before any action runs, ORACLE checks it against a scope you define ahead of time, meaning the exact list of systems you are allowed to test. Actions are also classified by risk, and higher risk actions can require a person to approve them before they happen. Every finding, host, and service discovered during a test is stored in what the project calls an evidence graph, a structured record that tracks where each piece of information came from and how confident the tool is about it, rather than a plain list you would have to sort through by hand. Under the hood, the project combines a Python package for its command line interface and web control panel with a separate Go program that runs the actual test commands in an isolated, timed environment. To try it, you install the Python requirements, run the Go tests, run the Python tests, then start a demo web dashboard on your own computer. Running it against a real target requires you to state the scope directly on the command line. It can also run using a free, locally installed AI model through Ollama, so no external API key or cost is required. This is the free Community Edition, released under the MIT license, with 2 stars so far. Paid Pro and Enterprise editions exist for teams that need cloud based storage, multiple test runners, and formal compliance reports.

Copy-paste prompts

Prompt 1
Walk me through installing and running this project's demo web dashboard locally.
Prompt 2
Explain how the deterministic planner decides the next action during a mission.
Prompt 3
Show me how to run this against a real network scope safely.
Prompt 4
Help me set up the free local Ollama AI backend instead of a paid API.
Prompt 5
Explain what the evidence graph stores and why it uses provenance and confidence scoring.

Frequently asked questions

What is oracle-mission-control?

A deterministic mission-planning tool for authorized security testing that keeps a rule-based planner, not an AI, in control of every action.

What language is oracle-mission-control written in?

Mainly Python. The stack also includes Python, Go, Ollama.

How hard is oracle-mission-control to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is oracle-mission-control for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.