{"id":50996784,"url":"https://github.com/tatmanblue/stonkinator","last_synced_at":"2026-06-20T10:32:25.173Z","repository":{"id":356952702,"uuid":"1234727352","full_name":"tatmanblue/stonkinator","owner":"tatmanblue","description":"Stonkinator--an AI enabled tool for technical analysis of stocks","archived":false,"fork":false,"pushed_at":"2026-05-24T16:08:39.000Z","size":677,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T18:12:00.899Z","etag":null,"topics":["ai","ai-agents","csharp","dotnet","dotnet-core","finance","financial-analysis"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tatmanblue.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-10T15:07:29.000Z","updated_at":"2026-05-24T16:08:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tatmanblue/stonkinator","commit_stats":null,"previous_names":["tatmanblue/stonkinator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tatmanblue/stonkinator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tatmanblue%2Fstonkinator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tatmanblue%2Fstonkinator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tatmanblue%2Fstonkinator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tatmanblue%2Fstonkinator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tatmanblue","download_url":"https://codeload.github.com/tatmanblue/stonkinator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tatmanblue%2Fstonkinator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34566920,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-20T02:00:06.407Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","csharp","dotnet","dotnet-core","finance","financial-analysis"],"created_at":"2026-06-20T10:32:23.769Z","updated_at":"2026-06-20T10:32:25.160Z","avatar_url":"https://github.com/tatmanblue.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# The Stonkinator\n\nAKA Stonks for short.\n\n![image.jpg](docs/image.jpg)\n\n\n**AI-Powered Technical Analysis for Stocks \u0026 Financial Instruments**\n\n\u003e **Educational Tool Only** — Not Financial Advice.  Please read the entire [disclaimer below](#disclaimer) before using.\n\nStonks 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.\n\n**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.\n\n---\n\n## Project Overview\n\nStonks follows a **client-server architecture**:\n\n- **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.\n- **Stonks Desktop Client** — A modern cross-platform desktop application that provides an intuitive user interface for traders to interact with the system.\n\nFuture clients (Web, Mobile) are possible and the architecture has been designed with this extensibility in mind.\n\n---\n\n## Key Features\n\n- AI-driven technical analysis (patterns, trends, indicators)\n- Support for classic patterns (Head \u0026 Shoulders, Cup \u0026 Handle, etc.)\n- Key indicators: RSI, MACD, Moving Averages, Bollinger Bands, Fibonacci, Volume Analysis, Support/Resistance\n- Interactive candlestick charts with overlays\n- (optional) Real-time and historical market data integration\n- Watchlist and saved analysis management\n- Clear, educational explanations of AI insights\n- Cross-platform desktop support (Windows, macOS, Linux)\n\n---\n\n## Architecture\n\n```\n┌─────────────────────┐       ┌──────────────────────┐\n│  Stonks Server      │       │   Stonks Desktop     │\n│   (ASP.NET Core)    │◄─────►│   Client (Avalonia)  │\n└─────────────────────┘       └──────────────────────┘\n│\n┌──────────────────────┼──────────────────────┐\n▼                      ▼                      ▼\nMarket Data APIs         AI / LLM APIs           Database\n(Polygon, Finnhub, etc.)   (Grok, Claude, GPT, etc.)\n```\n\n### Component Roles\n\n- **Server (`Stonks.Server`)**: \n  - Market data fetching \u0026 caching\n  - AI prompt orchestration and response processing\n  - REST + gRPC APIs\n  - Authentication \u0026 security\n  - Data persistence\n\n- **Desktop Client (`Stonks.Client.Desktop`)**: \n  - Rich interactive UI\n  - Chart visualization\n  - User experience \u0026 local settings\n  - Consumes server APIs\n\n- **Shared Libraries**: Common models, contracts, and utilities used across server and clients.\n\n---\n\n## Technical Stack\n\n* **Language:** C# 10 / .NET\n* **Frameworks:** ASP.NET Core (Server), Avalonia UI (Desktop)\n* **Communication:** gRPC (High-performance data streaming) \u0026 REST (Standard API operations)\n* **AI Integration:** Support for Vision-Language Models (VLM) and Large Language Models (LLM)\n\n\n---\n\n## Getting Started\n\n### Prerequisites\n\n- .NET 10.0 SDK or later\n- API keys for chosen market data and AI providers\n\n### Installation \u0026 Running (Development)\n\nSee [docs/INSTALLATION.md](docs/INSTALLATION.md) for prerequisites, environment configuration, and steps to run the server and desktop client locally.\n\n## Project Structure\n\nSee [docs/PROJECT_STRUCTURE.md](docs/PROJECT_STRUCTURE.md) for an annotated directory tree and descriptions of each project.\n\n\n\n---\n\n## Roadmap\n\n- [ ] MVP with core analysis flow\n- [ ] Multi-provider AI and data source support\n- [ ] Advanced charting and pattern visualization\n\n---\n\n## Disclaimer\n\n**This software is for educational purposes only.**\nIt 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 \nshall 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.   \n\nAI-generated analysis is experimental and may contain inaccuracies. Users should verify all data \nagainst official financial sources before making any decisions.\n\n**Past performance does not guarantee future results.**  \nTrading and investing involves substantial risk of loss. You can lose all your money.\n\n\n---\n\n## License\n\n[License](LICENSE)\n\n---\n\n## Contributing\n\nContributions are welcome! Please see `CONTRIBUTING.md` for guidelines.\n\n---\n\n## Status/Version\nMVP/Limited updates  \n2026.05.11  \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftatmanblue%2Fstonkinator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftatmanblue%2Fstonkinator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftatmanblue%2Fstonkinator/lists"}