{"id":17710816,"url":"https://github.com/engageintellect/stonk-ai","last_synced_at":"2025-04-21T03:32:04.264Z","repository":{"id":225104609,"uuid":"765069809","full_name":"engageintellect/stonk-ai","owner":"engageintellect","description":"An AI-powered Stock sentiment and technical analysis engine. Powered by Sveltekit, Python, OpenAI, and TensorFlow.","archived":false,"fork":false,"pushed_at":"2025-02-04T06:21:05.000Z","size":118147,"stargazers_count":12,"open_issues_count":3,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-01T09:11:14.770Z","etag":null,"topics":["ai","chatgpt","fastapi","finance","nginx","numpy","openai","python","stocks","svelte","sveltekit","systemd","tensorflow","typescript","ubuntu","uvicorn"],"latest_commit_sha":null,"homepage":"https://stonkai.xyz","language":"Svelte","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/engageintellect.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-02-29T08:18:46.000Z","updated_at":"2025-02-28T08:03:45.000Z","dependencies_parsed_at":"2024-06-25T04:44:44.629Z","dependency_job_id":"27b069f4-2f3e-4d29-a074-2f68b6665c7c","html_url":"https://github.com/engageintellect/stonk-ai","commit_stats":null,"previous_names":["engageintellect/ai-stock-client","engageintellect/stonk-ai"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engageintellect%2Fstonk-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engageintellect%2Fstonk-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engageintellect%2Fstonk-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engageintellect%2Fstonk-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/engageintellect","download_url":"https://codeload.github.com/engageintellect/stonk-ai/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249991057,"owners_count":21357194,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","chatgpt","fastapi","finance","nginx","numpy","openai","python","stocks","svelte","sveltekit","systemd","tensorflow","typescript","ubuntu","uvicorn"],"created_at":"2024-10-25T07:43:06.753Z","updated_at":"2025-04-21T03:32:03.599Z","avatar_url":"https://github.com/engageintellect.png","language":"Svelte","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ( UNDER CONSTRUCTION...)\n\n# stonk-ai\n\n## Description\n\nAn AI-powered stock market analysis and prediction engine that uses OpenAI's GPT-3.5/4/4o to analyze historic financial data, news headlines, and YouTube videos and predict future stock prices and performance.\n\n[![Stonk AI Logo](/assets/stonkai.png)](https://stonkai.xyz)\n\n## Features\n\n- [x] Search for stock symbols and get detailed information about the stock\n- [x] AI sentiment analysis of stock news headlines\n- [x] AI future price predictions\n- [x] Get the latest news about a stock\n- [x] Get the latest YouTube videos about a stock\n- [x] Options data\n- [x] Custom Themes\n- [ ] User Authentication - Coming soon...\n- [ ] User Posts - Coming soon...\n- [ ] User Sentiment - Coming soon...\n- [ ] Market fear and greed - Coming soon...\n\n[![Stonk AI Logo](/assets/stonkai-sentiment.png)](https://stonkai.xyz)\n\n## Installation:\n\n### First things first, some info...\n\nThis is a full-stack repository that contains both the client and server code.\n\nYou can run both the client and the server code locally. For deployment, I recommend using a cloud service like Vercel for the client and Heroku or a VPS for the server. The current deployment of this application is as follows:\n\n- Client: Vercel\n- Server: Ubuntu 20.04 VPS (Nginx, Uvicorn, SystemD)\n\n### Prerequisites\n\n#### Client\n\n##### Environment Variables\n\n1. YOUTUBE_API_KEY: You will need to create a YouTube API key and set it as an environment variable. You can do this by creating a .env file in the root of the project and adding the following line:\n\n2. OPENAI_API_KEY: You will need to create an OpenAI API key and set it as an environment variable. You can do this by creating a .env file in the root of the project and adding the following line:\n\n3. SERVER_URL: You will need to set the server url as an environment variable. You can do this by creating a .env file in the root of the project and adding the following line:\n\n```bash\nSERVER_URL=YOUR_SERVER_URL (e.g. http://localhost:8000)\n```\n\n#### Server\n\n1. A way to run Python code (e.g. a VPS, Heroku, etc.)\n2. A way to run FastAPI (e.g. Uvicorn, Gunicorn, etc.)\n3. A way to proxy requests to the FastAPI server (e.g. Nginx, Caddy, etc.)\n\n## Getting Started:\n\n## Running client\n\n1. Clone the repository\n\n```bash\ngit clone https://github.com/engageintellect/stonk-ai.git\ncd stonk-ai/client\n```\n\n2. Create a .env (or .env.local) file in the root of the project and add the following line:\n\n```bash\nYOUTUBE_API_KEY=YOUR_YOUTUBE_API_KEY\nOPENAI_API_KEY=YOUR_OPENAI_API_KEY\nSERVER_URL=YOUR_SERVER_URL\n```\n\n3. Install the dependencies\n\n```bash\npnpm install\n```\n\n4. Run the development server\n\n```bash\npnpm run dev\n```\n\n## Deployment\n\n### Client\n\n#### Build client\n\n```bash\npnpm run build\n```\n\n### Server\n\n1. Navigate to the server directory\n\n```bash\ncd stonk-ai/server\n```\n\n2. Create a new Python virtual environment\n\n```bash\npython3 -m venv venv \u0026\u0026 source venv/bin/activate\n```\n\n3. Install the dependencies\n\n```\npip3 install -r requirements.txt\n```\n\n4. Run the server code\n\n```\npython3 main.py\n```\n\n**NOTE:** Take note of the server URL. You will need it to set the SERVER_URL environment variable in the client.\n\n#### Logs\n\nserver logs can be found in `/stonk-ai/server/log.txt`.\n\n## Contributing\n\n1. Fork the repository\n2. Create a new branch (`git checkout -b feature`)\n3. Commit your changes (`git commit -am 'Add new feature'`)\n4. Push to the branch (`git push origin feature`)\n5. Create a new Pull Request\n\n## License\n\nMIT License\n\n## Acknowledgements\n\n- [OpenAI](https://openai.com)\n- [YouTube Data API](https://developers.google.com/youtube/v3)\n- [Financial Modeling Prep API](https://financialmodelingprep.com/developer/docs)\n- [Alpha Vantage API](https://www.alphavantage.co/documentation/)\n- [IEX Cloud API](https://iexcloud.io/docs/api/)\n- [Polygon.io API](https://polygon.io/docs/getting-started)\n- [Yahoo Finance API](https://www.yahoofinanceapi.com/)\n- [Finage API](https://finage.co.uk/docs)\n- [Finnhub API](https://finnhub.io/docs/api)\n- [Stock News API](https://stocknewsapi.com/)\n- [Stocktwits API](https://api.stocktwits.com/developers/docs)\n- [Twitter API](https://developer.twitter.com/en/docs)\n- [Reddit API](https://www.reddit.com/dev/api/)\n- [News API](https://newsapi.org/docs)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fengageintellect%2Fstonk-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fengageintellect%2Fstonk-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fengageintellect%2Fstonk-ai/lists"}