You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[**Omen**](https://github.com/StrategyLogic/omen) (Chinese: 爻) is a strategic reasoning engine based on **Explainable AI**. It leverages **ontological modeling** to understand the phenomena and essence of the strategic world, and **counterfactual analysis** to simulate the known and unknown in decision-making scenarios, generating verifiable, comparable, and explainable decision support for decision-makers.
6
10
7
-
> **Simulate the Signs. Reveal the Chaos.**
8
-
9
-
[**Omen**](https://github.com/StrategyLogic/omen) (Chinese: 爻) is an open-source strategic reasoning engine. It leverages multi-agent game theory, capability space modeling to simulate phenomena, and counterfactual analysis to reason how technological evolution impacts market landscapes.
Unlike traditional predictive models, Omen does not promise to *predict a certain future*. Instead, it generates **interpretable, replayable, and comparable future branching paths**. Its core responsibility is to reveal faint omens, critical branching points, and evolutionary trajectories within complex systems, empowering founders, product strategists, technology leaders, and investment analysts to understand:
15
+
> **Simulate the Signs. Reveal the Chaos.**
16
+
17
+
Unlike traditional predictive models, Omen is designed for complex strategic reasoning and does not promise to *predict a certain future*. Instead, it generates **interpretable, replayable, and comparable future branching paths**. Its core responsibility is to reveal faint omens, critical branching points, and evolutionary trajectories within complex systems, empowering founders, product strategists, technology leaders, and investment analysts to understand:
16
18
17
19
* 🔄 **Substitution Logic**: Which technology will replace another under what critical conditions?
18
20
* 🛡️ **Capability Evolution**: Which core capabilities will be enhanced first, and which will coexist long-term?
@@ -46,12 +48,6 @@ A complete reasoning session typically answers the following questions:
46
48
47
49
Environment requirements: Python 3.12+ with `pip` package manager.
omen simulate --scenario data/scenarios/ontology.json
66
-
67
-
# run simulate with stable seed (reproducible)
68
-
omen simulate --scenario data/scenarios/ontology.json --seed 42
69
-
70
-
# explain results
71
-
omen explain --input output/result.json
72
-
73
-
# compare scenarios with generic overrides
74
-
omen compare --scenario data/scenarios/ontology.json --overrides '{"user_overlap_threshold": 0.9}'
75
-
76
-
# compare with business parameter entrypoint (budget shock)
77
-
omen compare --scenario data/scenarios/ontology.json --budget-actor ai-memory --budget-delta 200
78
-
79
-
# keep historical outputs
80
-
omen compare --scenario data/scenarios/ontology.json --budget-actor ai-memory --budget-delta 200 --incremental
60
+
# Step 1. analyze situation from a built-in case
61
+
omen analyze situation --doc sap_reltio_acquisition --pack-id sap
62
+
# Step 2. generate scenario planning artifact from situation
63
+
omen scenario --situation sap
81
64
```
82
65
83
66
### View Results
84
67
85
-
**Local File Protection**: Output files are written to the root-level `output/` directory, which is excluded in `.gitignore` to avoid being tracked or accidentally uploaded, protecting your data from leakage.
By default, each run of the simulation will overwrite the previous results; you can add the `--incremental` to generate new files with a timestamp suffix, which applies to all `omen CLI` commands.
68
+
**Strategic Actor Persona UI**
90
69
91
70
```bash
92
-
# This will not overwrite the previous output (output file will automatically have a timestamp suffix)
93
-
omen simulate --scenario data/scenarios/ontology.json --incremental
71
+
streamlit run app/strategic_actor.py
94
72
```
95
73
96
-
By default, `simulate` use random seed to generate non-deterministic results; you can set a fixed `--seed` for reproducibility, it is recommended to compare different scenarios with the same seed to see the pure impact of parameter changes without random noise.
74
+
Then open `http://localhost:8501` and select a case from `cases/actors/` to view persona narrative, graph, and timeline.
75
+
76
+
**Strategic Situation Brief**
77
+
78
+
After `omen analyze situation`, read the generated brief:
97
79
98
80
```bash
99
-
# Run simulate with a fixed seed (results will be reproducible)
100
-
omen compare --scenario data/scenarios/ontology.json --budget-actor ai-memory --budget-delta 200 --seed 42
101
-
# Run another scenario with the same seed to compare results
102
-
omen compare --scenario data/scenarios/ontology.json --budget-actor ai-memory --budget-delta 300 --seed 42
81
+
# Example brief path
82
+
data/scenarios/sap/situation.md
103
83
```
104
84
105
85
Want to learn more? Read the [precision evaluation](docs/precision.md) document.
0 commit comments