{"id":21125435,"url":"https://github.com/pirate-emperor/aethermind","last_synced_at":"2026-02-06T22:32:52.282Z","repository":{"id":263047205,"uuid":"889183671","full_name":"Pirate-Emperor/AetherMind","owner":"Pirate-Emperor","description":"AetherMind is an LLM agent framework built with Streamlit and LangChain. It offers customizable modules for document processing, visualization, and tool integrations, supporting both local and Docker setups for development and production deployment.","archived":false,"fork":false,"pushed_at":"2024-11-15T19:21:45.000Z","size":62,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-02T17:59:07.626Z","etag":null,"topics":["api","automation","cpanel","data-visualization","docker","langchain","large-language-models","nlp-machine-learning","nodejs","python","streamlit"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Pirate-Emperor.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}},"created_at":"2024-11-15T19:19:24.000Z","updated_at":"2024-11-16T11:54:02.000Z","dependencies_parsed_at":"2024-11-15T20:35:16.692Z","dependency_job_id":null,"html_url":"https://github.com/Pirate-Emperor/AetherMind","commit_stats":null,"previous_names":["pirate-emperor/aethermind"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pirate-Emperor%2FAetherMind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pirate-Emperor%2FAetherMind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pirate-Emperor%2FAetherMind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pirate-Emperor%2FAetherMind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Pirate-Emperor","download_url":"https://codeload.github.com/Pirate-Emperor/AetherMind/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234901808,"owners_count":18904517,"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":["api","automation","cpanel","data-visualization","docker","langchain","large-language-models","nlp-machine-learning","nodejs","python","streamlit"],"created_at":"2024-11-20T04:33:57.639Z","updated_at":"2026-02-06T22:32:52.255Z","avatar_url":"https://github.com/Pirate-Emperor.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AetherMind\n\nAetherMind is an intelligent LLM-powered agent project designed to explore the potential and applications of agents based on Large Language Models (LLMs). Built using **Streamlit** and **LangChain**, this project provides tools and utilities for creating and managing advanced LLM-based workflows.\n\n## Features\n\n- **Streamlit-based Interface**: User-friendly interaction layer for deploying and managing LLM agents.\n- **LangChain Integrations**: Flexible support for document parsing, vector stores, and advanced LLM pipelines.\n- **Custom Utility Scripts**: Automate tasks such as vector store updates and document processing.\n\n## To-Do List\n\n- [ ] Automate cleansing of uploaded/generated files.\n- [ ] Upgrade to newer model versions.\n\n## File Structure\n\n```\n├── .streamlit/         # Streamlit configurations\n├── callbacks/          # LangChain callback handlers\n├── configs/            # Project configuration files\n├── document_loaders/   # LangChain document loaders\n├── graphs/             # LangChain graph-based utilities\n├── pages/              # Streamlit multi-page setup\n├── parsers/            # LangChain custom parsers\n├── scripts/            # Individual utility scripts\n├── tools/              # LangChain tools\n├── utils/              # General utility functions\n├── app.js              # Node.js proxy for Streamlit app (cPanel workaround)\n├── AetherMind.py       # Streamlit app entry point\n├── loader.cjs          # cPanel Node.js entry point\n└── run.sh              # Production environment entry point\n```\n\n## Usage\n\n### Running Individual Scripts\n\nEnsure you are in the root directory of the project before running scripts.  \nExample for adding booknotes to the vector store:\n\n```bash\npython scripts/add_booknotes_to_vectorstore.py --file_path=./data/booknotes/sample.txt --book_name=\"Sample Book\"\n```\n\n### Local Development\n\nNote: **Windows is not supported** due to `pymilvus` requiring a Unix environment.\n\nTo run the app locally:\n\n```bash\nstreamlit run AetherMind.py\n```\n\n### Docker Development\n\nTo run the project using Docker:\n\n#### Without Rebuilding:\n\n```bash\ndocker-compose up\n```\n\n#### With Rebuilding:\n\n```bash\ndocker-compose up --build\n```\n\n### Production Deployment\n\nFor production, execute the following command:\n\n```bash\nbash run.sh\n```\n\n### Cleaning Docker WSL (Windows Only)\n\nIf using Docker with WSL on Windows, clean up space using the following commands:\n\n```bash\nwsl --shutdown\ndiskpart\nselect vdisk file=\"C:\\Users\\\u003cYourUsername\u003e\\AppData\\Local\\Docker\\wsl\\data\\ext4.vhdx\"\nattach vdisk readonly\ncompact vdisk\ndetach vdisk\n```\n\nReplace `\u003cYourUsername\u003e` with your actual Windows username.\n\n## Dependencies\n\nThis project requires:\n\n- **Python 3.9+**\n- Libraries:\n  - `streamlit`\n  - `langchain`\n  - `pymilvus`\n  - `docker`\n  - Other dependencies listed in `requirements.txt`.\n\nInstall dependencies with:\n\n```bash\npip install -r requirements.txt\n```\n\n## Contribution Guidelines\n\nWe welcome contributions! To contribute:\n\n1. Fork the repository.\n2. Create a feature branch (`git checkout -b feature/YourFeature`).\n3. Commit your changes (`git commit -m 'Add YourFeature'`).\n4. Push to the branch (`git push origin feature/YourFeature`).\n5. Open a pull request.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Author\n\n**Pirate-Emperor**\n\n[![Twitter](https://skillicons.dev/icons?i=twitter)](https://twitter.com/PirateKingRahul)\n[![Discord](https://skillicons.dev/icons?i=discord)](https://discord.com/users/1200728704981143634)\n[![LinkedIn](https://skillicons.dev/icons?i=linkedin)](https://www.linkedin.com/in/piratekingrahul)\n\n[![Reddit](https://img.shields.io/badge/Reddit-FF5700?style=for-the-badge\u0026logo=reddit\u0026logoColor=white)](https://www.reddit.com/u/PirateKingRahul)\n[![Medium](https://img.shields.io/badge/Medium-42404E?style=for-the-badge\u0026logo=medium\u0026logoColor=white)](https://medium.com/@piratekingrahul)\n\n- GitHub: [Pirate-Emperor](https://github.com/Pirate-Emperor)\n- Reddit: [PirateKingRahul](https://www.reddit.com/u/PirateKingRahul/)\n- Twitter: [PirateKingRahul](https://twitter.com/PirateKingRahul)\n- Discord: [PirateKingRahul](https://discord.com/users/1200728704981143634)\n- LinkedIn: [PirateKingRahul](https://www.linkedin.com/in/piratekingrahul)\n- Skype: [Join Skype](https://join.skype.com/invite/yfjOJG3wv9Ki)\n- Medium: [PirateKingRahul](https://medium.com/@piratekingrahul)\n\nThank you for visiting the CipherX project!\n\n---\n\nFor more details, please refer to the [GitHub repository](https://github.com/Pirate-Emperor/CipherX).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpirate-emperor%2Faethermind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpirate-emperor%2Faethermind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpirate-emperor%2Faethermind/lists"}