{"id":25412807,"url":"https://github.com/techednelson/aiops-nexus","last_synced_at":"2025-09-02T11:04:51.722Z","repository":{"id":277701607,"uuid":"929597653","full_name":"techednelson/aiops-nexus","owner":"techednelson","description":"AIOps Nexus is an open-source intelligent operations platform that uses AI to simplify IT operations through automated log analysis and effective problem-solving.","archived":false,"fork":false,"pushed_at":"2025-02-20T23:39:17.000Z","size":640,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-16T01:50:48.479Z","etag":null,"topics":["aiops","artificial-intelligence","automation","devops","docker","docker-compose","it-operations","kubernetes","langchain-python","large-language-models","linux","machine-learning","monitoring","ollama","openwebui","platform-engineering","poetry-python","python3","site-reliability-engineering-sre","vagrant"],"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/techednelson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-08T23:07:10.000Z","updated_at":"2025-04-06T18:31:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"2308937d-0df3-46d5-bff6-6130d9256c4f","html_url":"https://github.com/techednelson/aiops-nexus","commit_stats":null,"previous_names":["techednelson/aiops-nexus"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/techednelson/aiops-nexus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techednelson%2Faiops-nexus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techednelson%2Faiops-nexus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techednelson%2Faiops-nexus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techednelson%2Faiops-nexus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/techednelson","download_url":"https://codeload.github.com/techednelson/aiops-nexus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techednelson%2Faiops-nexus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273272560,"owners_count":25075985,"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","status":"online","status_checked_at":"2025-09-02T02:00:09.530Z","response_time":77,"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":["aiops","artificial-intelligence","automation","devops","docker","docker-compose","it-operations","kubernetes","langchain-python","large-language-models","linux","machine-learning","monitoring","ollama","openwebui","platform-engineering","poetry-python","python3","site-reliability-engineering-sre","vagrant"],"created_at":"2025-02-16T13:27:59.100Z","updated_at":"2025-09-02T11:04:51.709Z","avatar_url":"https://github.com/techednelson.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AIOps Nexus\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./images/aiops-nexus.jpg\" alt=\"name\"/\u003e\n\u003cp/\u003e\n\n\u003ch4 align=\"center\"\u003eBest practices to gain maximum engagements, contributions, and acknowledgements(like stars, sponsors)\u003c/h4\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/techednelson/aiops-nexus/blob/master/LICENSE\" target=\"blank\"\u003e\n\u003cimg src=\"https://img.shields.io/github/license/techednelson/aiops-nexus?style=flat-square\" alt=\"tryshape licence\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/techednelson/aiops-nexus/fork\" target=\"blank\"\u003e\n\u003cimg src=\"https://img.shields.io/github/forks/techednelson/aiops-nexus?style=flat-square\" alt=\"tryshape forks\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/techednelson/aiops-nexus/stargazers\" target=\"blank\"\u003e\n\u003cimg src=\"https://img.shields.io/github/stars/techednelson/aiops-nexus?style=flat-square\" alt=\"tryshape stars\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/techednelson/aiops-nexus/issues\" target=\"blank\"\u003e\n\u003cimg src=\"https://img.shields.io/github/issues/techednelson/aiops-nexus?style=flat-square\" alt=\"tryshape issues\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/techednelson/aiops-nexus/pulls\" target=\"blank\"\u003e\n\u003cimg src=\"https://img.shields.io/github/issues-pr/techednelson/aiops-nexus?style=flat-square\" alt=\"tryshape pull-requests\"/\u003e\n\u003c/a\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/techednelson/aiops-nexus/issues/new?template=bug_report.md\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/techednelson/aiops-nexus/issues/new?template=feature_request.md\"\u003eRequest Feature\u003c/a\u003e\n\u003c/p\u003e\n\n# 👋 Introducing `AIOps Nexus`\n\n`AIOps Nexus` is an open-source, **dockerized application** that simplifies IT operations by analyzing logs from monitoring tools like **OpenSearch**, **Elasticsearch**, **Alertmanager**, **Prometheus**, and more. It uses free, **open-source LLMs** to identify root causes and generate actionable solutions, delivering them via webhooks to platforms like Slack and Discord.\n\nDeployable within corporate infrastructure (e.g., inside a VPN) or on cloud VMs with controlled access, `AIOps Nexus` ensures data security by avoiding internet exposure. It is ideal for organizations prioritizing privacy while leveraging AI to enhance operational efficiency at minimal costs, limited to the hardware or VM where it is deployed.\n\n# 🔥 Key Features\n\n- ✨ **[Dynamic LLM Selection](https://ollama.com/search)**: Choose from various **open-source LLMs** (e.g., [Llama3](https://ai.meta.com/blog/meta-llama-3/), [Mistral](https://mistral.ai/en), [DeepSeek-R1](https://www.deepseek.com/), and more via Ollama) to meet specific user needs.\n- 🆓 **Free and Open Source**: Utilize completely free, **open-source LLM** models without incurring API costs—your only expense is the hardware or VM where the app is deployed.\n- 📈 **Log Analysis**: Automatically analyze logs from monitoring tools to identify root causes of incidents.\n- 🎬 **Actionable Solutions**: Generate and deliver solutions via webhooks to platforms like Slack and Discord for team awareness and collaboration.\n- 🧠 **Caching Mechanism**: Optimize performance by caching repeated queries for faster responses.\n\n# 🔑 Why Use `AIOps Nexus`?\n\n`AIOps Nexus` enables companies and users to integrate AI into their operations effortlessly, supporting incident resolution and operational efficiency at no additional cost beyond infrastructure. By combining cutting-edge AI with a user-friendly interface, this project empowers teams to focus on solving problems rather than managing tools.\n\nLiked it? Please give a ⭐️ to \u003cb\u003eAIOps Nexus\u003c/b\u003e.\n\n## Many Thanks to all who has supported this project with stars(⭐)\n\n\n# 🏁 To start using `AIOps Nexus`\n\nFirst [Install Docker Desktop](https://docs.docker.com/compose/install/) if you don't have installed it yet.\n\n### Docker\n**Ideal for fast deployment and local testing.**\n```\ndocker run --name aiops-nexus -e LLM=llama3.2 -p 5000:5000 ghcr.io/techednelson/aiops-nexus:latest\n```\nTest `AIOps Nexus` api with:\n```\ncurl -X POST http://localhost:5000/api/alert \\\n-H \"Content-Type: application/json\" \\\n-d '{\"ERROR\": \"10.185.248.71 - - [09/Jan/2015:19:12:06 +0000] 808840 \\\"GET inventoryService/inventory/purchaseItem? userId=20253471\u0026itemId=23434300 HTTP/1.1\\\" 500 17 \\\"-\\\" \\\"Apache-HttpClient/4.2.6 (java 1.5)\\\"\"}'\n\n```\n\u003e 💡 **Important Notes**\n\u003e\n\u003e The `aiops-nexus` Docker image comes with the pre-installed [llama3.2(3B)](https://ollama.com/library/llama3.2) model, allowing quick startup with minimal hardware (**2 CPUs** and **4GB RAM**). Setting the `LLM` environment variable to a different model will download it on startup, which may take time and require more resources.\n\u003e\n\u003e For larger models according to [ollama reference](https://github.com/ollama/ollama#model-library):\n\u003e- **7B**: At least 8GB RAM\n\u003e- **13B**: At least 16GB RAM\n\u003e- **33B**: At least 32GB RAM \n### Docker Compose (Integration with Open-Webui)\n**Ideal for quick deployment on Cloud VMs with controlled access or VMs in a corporate envinment within a VPN. Perfect for companies looking to keep prompts and GPT responses secure without internet exposure. Use it for AIOps log analysis or interact directly with Ollama LLMs through a user-friendly Open-WebUI for technical consultations.**\n```\nservices:\n  aiops-nexus:\n    container_name: aiops-nexus\n    image: ghcr.io/techednelson/aiops-nexus:latest\n    working_dir: /aiops-nexus\n    environment:\n      DEBUG: 1\n      WEBHOOK_URL: https://hooks.slack.com/services/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx # slack and discord are compatible at this moment\n      LLM: llama3.2 # if LLM is left blank, pre-installed llama3.2 will be loaded\n    volumes:\n      - ./app:/aiops-nexus/app\n    ports:\n      - \"5000:5000\"\n      - \"11434\"\n    restart: on-failure\n  open-webui:\n    container_name: open-webui\n    image: ghcr.io/open-webui/open-webui:main\n    environment:\n      - OLLAMA_BASE_URL=http://aiops-nexus:11434\n    volumes:\n      - open-webui:/app/backend/data\n    ports:\n      - \"3000:8080\"\n    restart: always\n\nvolumes:\n  open-webui:\n```\nTest `AIOps Nexus` api with:\n```\ncurl -X POST http://localhost:5000/api/alert \\\n-H \"Content-Type: application/json\" \\\n-d '{\"ERROR\": \"10.185.248.71 - - [09/Jan/2015:19:12:06 +0000] 808840 \\\"GET inventoryService/inventory/purchaseItem? userId=20253471\u0026itemId=23434300 HTTP/1.1\\\" 500 17 \\\"-\\\" \\\"Apache-HttpClient/4.2.6 (java 1.5)\\\"\"}'\n\n```\n\nAccess Open-WebUI at [http://localhost:3000](http://localhost:3000).\n\n- Enter any value in `Full Name`, `Email`, and `Password` fields to sign up.\n\n# 🚧 To start developing `AIOps Nexus`\n\n1. Install docker desktop (skip if you already have it installed):\n\n[Install Docker Desktop](https://docs.docker.com/compose/install/)\n\n2. Clone the repository:\n\n```bash\ngit clone https://github.com/techednelson/aiops-nexus\n```\n\n3. Change the working directory:\n\n```bash\ncd aiops-nexus\n```\n\n4. Run the app\n\n```bash\ndocker compose up # or, docker compose up -d to avoid logs\n```\n\nThat's All!!!\n\n- Access Open-WebUI at [http://localhost:3000](http://localhost:3000).\n\nEnter any value in `Full Name`, `Email`, and `Password` fields to sign up.\n\n- Interact with `AIOps Nexus` api at http://localhost:5000/api/alert\n\n```\ncurl -X POST http://localhost:5000/api/alert \\\n-H \"Content-Type: application/json\" \\\n-d '{\"ERROR\": \"10.185.248.71 - - [09/Jan/2015:19:12:06 +0000] 808840 \\\"GET inventoryService/inventory/purchaseItem? userId=20253471\u0026itemId=23434300 HTTP/1.1\\\" 500 17 \\\"-\\\" \\\"Apache-HttpClient/4.2.6 (java 1.5)\\\"\"}'\n\n```\n\n# 📖 Nexus AIOps Integration: Proven Examples for Seamless Operations\n\n### Integration with OpenSearch and Slack (Kubernetes Setup)\n\n🚧 `Under construction`\n\n- Follow detailed instructions here: [`examples/opensearch/README.md`](./examples/opensearch/README.md)\n\n### Integration with Elasticsearch and Discord (Docker Compose Setup)\n\n🚧 `Comming Soon...`\n\n- Follow detailed instructions here: [`examples/elasticsearch/README.md`](./examples/elasticsearch/README.md)\n\n# 🍔 Built With\n- [Python](https://www.python.org)\n- [Fastapi](https://fastapi.tiangolo.com)\n- [poetry](https://python-poetry.org)\n- [Docker](https://www.docker.com)\n- [Ollama](https://ollama.com)\n- [Langchain](https://python-poetry.org/)\n- [Open-Webui](https://docs.openwebui.com)\n\n# 🛡️ License\nThis project is licensed under the MIT License - see the [`LICENSE`](LICENSE) file for details.\n\n# 🦄 Upcoming Features\n`AIOps Nexus` has all the potentials to grow further. Here are some of the posible upcoming features planned(not in any order),\n\n- ✔️ Replace InMemory cache for redis.\n- ✔️ Incorporate embeddings in some way.\n- ✔️ Add realtime processing pipelines with kafka.\n- ✔️ Add support for Teams webhooks.\n\nIf you find something is missing, `AIOps Nexus` is listening. Please create a feature request [from here](https://github.com/techednelson/aiops-nexus/issues/new?template=feature_request.md).\n\n# 🤝 Contributing to `AIOps Nexus`\nAny kind of positive contribution is welcome! Please help us to grow by contributing to the project.\n\nIf you wish to contribute, you can work on any features [listed here](https://github.com/techednelson/aiops-nexus#-upcoming-features) or create one on your own. After adding your code, please send us a Pull Request.\n\n\u003e Please read [`CONTRIBUTING`](CONTRIBUTING.md) for details on our [`CODE OF CONDUCT`](CODE_OF_CONDUCT.md), and the process for submitting pull requests to us.\n\n# 🙏 Support\n\nWe all need support and motivation. `AIOps Nexus` is not an exception. If you found this app helpful, consider supporting us with a ⭐️.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechednelson%2Faiops-nexus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechednelson%2Faiops-nexus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechednelson%2Faiops-nexus/lists"}