https://github.com/tatmanblue/stonkinator
Stonkinator--an AI enabled tool for technical analysis of stocks
https://github.com/tatmanblue/stonkinator
ai ai-agents csharp dotnet dotnet-core finance financial-analysis
Last synced: 27 days ago
JSON representation
Stonkinator--an AI enabled tool for technical analysis of stocks
- Host: GitHub
- URL: https://github.com/tatmanblue/stonkinator
- Owner: tatmanblue
- License: apache-2.0
- Created: 2026-05-10T15:07:29.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-24T16:08:39.000Z (about 2 months ago)
- Last Synced: 2026-05-24T18:12:00.899Z (about 2 months ago)
- Topics: ai, ai-agents, csharp, dotnet, dotnet-core, finance, financial-analysis
- Language: C#
- Homepage:
- Size: 661 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# The Stonkinator
AKA Stonks for short.
**AI-Powered Technical Analysis for Stocks & Financial Instruments**
> **Educational Tool Only** — Not Financial Advice. Please read the entire [disclaimer below](#disclaimer) before using.
Stonks is an application that leverages modern AI models to provide technical analysis, pattern recognition, and actionable insights for stocks and other financial instruments. It is designed primarily for speculative day traders and retail investors who want to deepen their understanding of technical analysis.
**Important Disclaimer**: This application is built for **educational and research purposes only**. It does not provide financial advice, nor does it execute or recommend live trades. Always do your own research and consult qualified professionals before making investment decisions.
---
## Project Overview
Stonks follows a **client-server architecture**:
- **Stonks Server** — The brain of the application. Handles data retrieval from market APIs, orchestration with AI models (LLMs + Vision), technical analysis logic, and serves results via APIs.
- **Stonks Desktop Client** — A modern cross-platform desktop application that provides an intuitive user interface for traders to interact with the system.
Future clients (Web, Mobile) are possible and the architecture has been designed with this extensibility in mind.
---
## Key Features
- AI-driven technical analysis (patterns, trends, indicators)
- Support for classic patterns (Head & Shoulders, Cup & Handle, etc.)
- Key indicators: RSI, MACD, Moving Averages, Bollinger Bands, Fibonacci, Volume Analysis, Support/Resistance
- Interactive candlestick charts with overlays
- (optional) Real-time and historical market data integration
- Watchlist and saved analysis management
- Clear, educational explanations of AI insights
- Cross-platform desktop support (Windows, macOS, Linux)
---
## Architecture
```
┌─────────────────────┐ ┌──────────────────────┐
│ Stonks Server │ │ Stonks Desktop │
│ (ASP.NET Core) │◄─────►│ Client (Avalonia) │
└─────────────────────┘ └──────────────────────┘
│
┌──────────────────────┼──────────────────────┐
▼ ▼ ▼
Market Data APIs AI / LLM APIs Database
(Polygon, Finnhub, etc.) (Grok, Claude, GPT, etc.)
```
### Component Roles
- **Server (`Stonks.Server`)**:
- Market data fetching & caching
- AI prompt orchestration and response processing
- REST + gRPC APIs
- Authentication & security
- Data persistence
- **Desktop Client (`Stonks.Client.Desktop`)**:
- Rich interactive UI
- Chart visualization
- User experience & local settings
- Consumes server APIs
- **Shared Libraries**: Common models, contracts, and utilities used across server and clients.
---
## Technical Stack
* **Language:** C# 10 / .NET
* **Frameworks:** ASP.NET Core (Server), Avalonia UI (Desktop)
* **Communication:** gRPC (High-performance data streaming) & REST (Standard API operations)
* **AI Integration:** Support for Vision-Language Models (VLM) and Large Language Models (LLM)
---
## Getting Started
### Prerequisites
- .NET 10.0 SDK or later
- API keys for chosen market data and AI providers
### Installation & Running (Development)
See [docs/INSTALLATION.md](docs/INSTALLATION.md) for prerequisites, environment configuration, and steps to run the server and desktop client locally.
## Project Structure
See [docs/PROJECT_STRUCTURE.md](docs/PROJECT_STRUCTURE.md) for an annotated directory tree and descriptions of each project.
---
## Roadmap
- [ ] MVP with core analysis flow
- [ ] Multi-provider AI and data source support
- [ ] Advanced charting and pattern visualization
---
## Disclaimer
**This software is for educational purposes only.**
It does not constitute financial, investment, or trading advice. The developers are not registered financial advisors. Use at your own risk. The author(s) and contributors
shall not be held liable for any financial losses or damages resulting from the use of this software. Always do your own research and consult a licensed financial advisor before making any investment decisions.
AI-generated analysis is experimental and may contain inaccuracies. Users should verify all data
against official financial sources before making any decisions.
**Past performance does not guarantee future results.**
Trading and investing involves substantial risk of loss. You can lose all your money.
---
## License
[License](LICENSE)
---
## Contributing
Contributions are welcome! Please see `CONTRIBUTING.md` for guidelines.
---
## Status/Version
MVP/Limited updates
2026.05.11