{"id":28088937,"url":"https://github.com/tnickster/ai-analyst-agent","last_synced_at":"2026-04-08T18:31:19.608Z","repository":{"id":292895476,"uuid":"982296861","full_name":"tnickster/ai-analyst-agent","owner":"tnickster","description":"Ask questions about your business data in plain English,  Get automatic SQL queries and visualizations, Receive AI-powered insights and recommendations, No SQL knowledge required","archived":false,"fork":false,"pushed_at":"2025-05-22T20:45:41.000Z","size":162,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-03T18:53:11.058Z","etag":null,"topics":["ai-assistant","business-analytics","business-intelligence","data-analysis","data-analyst","data-visualization","database-query","gpt-4","langchain","llm","mysql","natural-language-processing","openai","plotly","python","sql-generation","streamlit"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tnickster.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}},"created_at":"2025-05-12T17:04:51.000Z","updated_at":"2025-12-14T14:12:44.000Z","dependencies_parsed_at":"2025-05-22T22:38:53.883Z","dependency_job_id":null,"html_url":"https://github.com/tnickster/ai-analyst-agent","commit_stats":null,"previous_names":["tnickster/ai-analyst-agent"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/tnickster/ai-analyst-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tnickster%2Fai-analyst-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tnickster%2Fai-analyst-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tnickster%2Fai-analyst-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tnickster%2Fai-analyst-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tnickster","download_url":"https://codeload.github.com/tnickster/ai-analyst-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tnickster%2Fai-analyst-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31568579,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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-assistant","business-analytics","business-intelligence","data-analysis","data-analyst","data-visualization","database-query","gpt-4","langchain","llm","mysql","natural-language-processing","openai","plotly","python","sql-generation","streamlit"],"created_at":"2025-05-13T12:52:39.048Z","updated_at":"2026-04-08T18:31:19.581Z","avatar_url":"https://github.com/tnickster.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Business Insights Agent\r\n\r\nAn intelligent business analytics platform powered by LLMs that translates natural language questions into SQL queries, creates visualizations, and provides actionable insights.\r\n\r\n## 📸 Screenshots\r\n\r\n### 1. Asking a question\r\n![Agent input prompt](images/agent_input.png)\r\n\r\n### 2. Employees per department\r\n![Bar Graph](images/dept_numbers_split.png)\r\n\r\n### 3. Overall gender distribution \u0026 Follow-up\r\n![Overall gender pie](images/gender_pie.png)\r\n\r\n## Features\r\n\r\n- 💬 **Natural Language Interface**: Ask questions in plain English about your business data\r\n- 📊 **Automatic Visualizations**: Generates appropriate charts based on query results\r\n- 🔍 **Root Cause Analysis**: Identifies underlying factors contributing to business trends\r\n- 📈 **Actionable Recommendations**: Suggests next steps based on data insights\r\n- 🔄 **Follow-up Questions**: Recommends additional queries to deepen your analysis\r\n\r\n## Tech Stack\r\n\r\n- **Backend**: Python, MySQL, LangChain\r\n- **LLM Integration**: OpenAI GPT-4\r\n- **Data Processing**: Pandas\r\n- **Visualization**: Plotly\r\n- **Frontend**: Streamlit\r\n\r\n## How It Works\r\n\r\n1. User asks a business question in natural language\r\n2. LLM agent interprets the question and generates appropriate SQL queries\r\n3. Queries are executed against the MySQL database\r\n4. Results are processed and visualized\r\n5. LLM provides insights, analyses, and recommendations based on the data\r\n\r\n## Getting Started\r\n\r\n### Prerequisites\r\n\r\n- Python 3.8+\r\n- MySQL database with your business data\r\n- OpenAI API key\r\n\r\n### Installation\r\n\r\n1. Clone this repository\r\n   ```bash\r\n   git clone https://github.com/tnickster/ai-analyst-agent.git\r\n   cd ai-analyst-agent\r\n   ```\r\n\r\n2. Install dependencies\r\n   ```bash\r\n   pip install -r requirements.txt\r\n   ```\r\n\r\n3. Create a `.env` file with your configuration\r\n   ```\r\n   OPENAI_API_KEY=your_openai_api_key \r\n   DB_HOST=your_db_host\r\n   DB_PORT=your_db_host\r\n   DB_USER=your_db_user\r\n   DB_PASSWORD=your_db_password\r\n   DB_NAME=your_db_name\r\n   ```\r\n\r\n### Running the Application\r\n\r\n#### Streamlit Web Interface\r\n```bash\r\nstreamlit run app.py\r\n```\r\n\r\n#### Command Line Interface\r\n```bash\r\npython main.py\r\n```\r\n\r\n## Project Structure\r\n\r\n```\r\n├── app.py              # Streamlit web interface\r\n├── main.py             # Command line interface\r\n├── tools.py            # Core functionality, SQL processing, visualization\r\n├── prompt.txt          # System prompt for the LLM agent\r\n├── requirements.txt    # Python dependencies\r\n└── README.md           # This file\r\n```\r\n\r\n## Demo\r\n\r\nSoon to be implemented\r\n\r\n## Future Improvements\r\n\r\n- Support for additional databases (PostgreSQL, SQLite, etc.)\r\n- Custom visualization options\r\n- Data export functionality\r\n- User authentication and access controls\r\n- Multi-tenant support for multiple databases\r\n\r\n## Contributing\r\n\r\nContributions are welcome! Please feel free to submit a Pull Request.\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the LICENSE file for details.\r\n\r\n## Contact\r\n\r\nNicholas Tarazi - Nicholas.Tarazi7@gmail.com\r\n\r\nLinkedIn: https://www.linkedin.com/in/nicholas-tarazi/\r\n\r\nProject Link: [https://github.com/tnickster/ai-analyst-agent](https://github.com/tnickster/ai-analyst-agent)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftnickster%2Fai-analyst-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftnickster%2Fai-analyst-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftnickster%2Fai-analyst-agent/lists"}