English | Español | Português | 中文
FinSim-AI is an advanced simulator of financial market dynamics powered by multiple Artificial Intelligence agents with conflicting incentives and mandates. Unlike linear simulations, this engine explores the emergent behavior of the market through an isolated multi-agent architecture.
After running a simulation given a macroeconomic event or an environmental shock, the system generates a causal flow of reactions:
- Agent Reactions: Each agent (Retail, Hedge Fund, Institutional) issues a subjective judgment and a "Risk Score".
- Order Flow: The Market Maker agent (Citadel-MM) processes the aggregated orders to determine actual liquidity.
- CIO Report: A fifth agent synthesizes everything into a strategic narrative, calculating probabilities (Bull/Bear/Neutral) and a market conviction index.
The foundation of FinSim-AI lies in each agent operating in an environment of cognitive isolation during its decision turn.
- Opposing Incentives: Each agent has a specific portfolio and mandate (e.g., Vanguard seeks safety, Aura seeks asymmetry).
- Shared Memory: At the end of each turn, the CIO report is injected into the memory of all agents, creating a "market consciousness" for the next cycle.
- Sequential Causality: Reactions are not random; they are based on the current state of Inflation, Rates, and Global Liquidity.
FinSim-AI is model-agnostic. You can configure various brains for your agents.
- Providers: Support for OpenRouter, OpenAI, and Google Gemini.
- Models: From lightweight models (flash) to powerful reasoning models (o1, gpt-4o).
- Engine Parameters:
- Max Tokens: Controls the depth of the agents' narrative.
- Temperature: Adjusts determinism vs. creativity in the reactions.
- Initial State: Defines the macroeconomic starting point (Inflation, Rates, and Liquidity).
If you want to run the project from source or contribute to the development, follow these steps:
- Have the .NET SDK (v8.0 or higher) installed.
- Clone the repository:
git clone https://github.com/EconomiaUNMSM/FinSim-AI.git cd FinSim-AI - Install dependencies:
dotnet restore
- Run the application:
The application will automatically open in your default browser (usually at http://localhost:5000).
dotnet run
FinSim-AI serves to explore "What If" scenarios in complex financial environments, allowing one to understand how the psychology of different participants interacts with macroeconomic news.
- Financial Education: Understand the relationship between interest rates and risk appetite.
- Narrative Analysis: Observe how a piece of news can be interpreted in opposing ways by different sectors.
- Financial Wargaming: Simulate speculative attacks or liquidity crises.
- Synthetic Nature: Reactions depend on the quality of the language model used.
- Lack of Real Execution: It is a qualitative simulator, not a quantitative trading engine. It does not process real-time market data.
THIS IS STRICTLY AN EDUCATIONAL AND ENTERTAINMENT TOOL. FinSim-AI does not constitute, nor should it be interpreted as:
- Professional financial advice.
- Investment or trading recommendations.
- Real projections of market behavior.
Financial investments carry significant risks. Always consult with a certified financial advisor before making any real investment decision. The author is not responsible for losses incurred by the use of this tool.
Developed by EconomiaUNMSM.