{"id":28625643,"url":"https://github.com/lahadiyani/soami","last_synced_at":"2025-06-12T08:11:11.799Z","repository":{"id":292855937,"uuid":"982165755","full_name":"lahadiyani/soami","owner":"lahadiyani","description":"soami adalah starter framework modular yang bisa anda customisasi untuk membangun dan menjalankan AI Agents (seperti `Researcher`, `Planner`, dan `Coder`) berbasis Python, Flask. Cocok untuk membangun prototype AGI atau AI tooling dengan sistem orchestrator, memory, tools, dan vectorstore.","archived":false,"fork":false,"pushed_at":"2025-05-31T15:42:11.000Z","size":1531,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-01T03:50:00.627Z","etag":null,"topics":["ai-agents","llm-framework","workflow"],"latest_commit_sha":null,"homepage":"","language":"Python","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/lahadiyani.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,"zenodo":null}},"created_at":"2025-05-12T13:23:09.000Z","updated_at":"2025-05-31T15:42:15.000Z","dependencies_parsed_at":"2025-05-12T14:45:34.929Z","dependency_job_id":"b92340ed-c703-465e-8485-2b5dc8ab39b4","html_url":"https://github.com/lahadiyani/soami","commit_stats":null,"previous_names":["lahadiyani/agilemind","lahadiyani/soami"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lahadiyani/soami","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lahadiyani%2Fsoami","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lahadiyani%2Fsoami/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lahadiyani%2Fsoami/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lahadiyani%2Fsoami/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lahadiyani","download_url":"https://codeload.github.com/lahadiyani/soami/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lahadiyani%2Fsoami/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259427072,"owners_count":22855564,"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-agents","llm-framework","workflow"],"created_at":"2025-06-12T08:11:09.588Z","updated_at":"2025-06-12T08:11:11.769Z","avatar_url":"https://github.com/lahadiyani.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Soami - Starter Framework AI Agent\n\n![logo](app/static/assets/icon.jpg)\n\n**Soami** adalah sebuah framework starter modular yang bisa kamu kustomisasi untuk membangun dan menjalankan AI Agent buatanmu. Cocok untuk membangun Ai agent atau alat bantu AI dengan sistem orchestrator, memory, tools, dan vectorstore.\n\n---\n\n## 🚀 Fitur Unggulan\n\n* ✅ Menggunakan Application Factory Pattern (Flask)\n* ✅ AI Agent Modular Setiap agent bisa dikembangkan secara terpisah dan dikombinasikan melalui orchestrator.\n* ✅ Mendukung Prompt Engineering Prompt disimpan dalam file template, mudah disesuaikan.\n* ✅ Terintegrasi dengan LangChain\n* ✅ Mendukung FAISS \u0026 ElasticSearch untuk vector database\n* ✅ MySQL untuk data relasional terstruktur\n* ✅ Custom (HTML, CSS, JavaScript native)\n* ✅ Siap untuk CI/CD \u0026 containerization (Docker)\n\n---\n\n## 🔧 Persyaratan\n\nInstall terlebih dahulu:\n\n* Python 3.10+\n* MySQL Server (lokal atau via Docker)\n* ElasticSearch (versi 8 ke atas)\n* FAISS (`faiss-cpu` atau `faiss-gpu`)\n* Docker (opsional namun direkomendasikan)\n\n---\n\n## 📦 Instalasi\n\n1. Clone repository:\n\n```bash\ngit clone https://github.com/lahadiyani/AGILEMinD.git\ncd AGILEMinD\n```\n\n2. Buat virtual environment:\n\n```bash\npython -m venv .venv\nsource .venv/bin/activate  # atau .\\.venv\\Scripts\\Activate untuk Windows\n```\n\n3. Pesiapan Sebelum Menginstall module\n\njika anda menggunakan sistem operasi linux pastikan `mariadb-connector-c-devel` dan `pkg-config` sudah terinstall pada komputer anda, jika belum anda bisa menginstallnya terlebih dahulu.\n\nuntuk RedHat, Fedora\n\n\n```sh\nsudo dnf install mysql-devel mariadb-connector-c-devel pkg-config\n```\n\nuntuk debian dan turunan nya (ubuntu, mint, xubuntu)\n\n```sh\nsudo apt update\nsudo apt install mysql-devel python3-dev default-libmysqlclient-dev build-essential pkg-config\n```\n\n4. Install dependencies:\n\n```bash\npip install -r requirements.txt\n```\n\n5. Konfigurasi `.env`:\n\n```env\nFLASK_APP=main.py\nFLASK_ENV=development\nDB_USER=root\nDB_PASSWORD=yourpassword\nDB_HOST=localhost\nDB_NAME=ai_agent_db\nDATABASE_URL=mysql+pymysql://root:yourpassword@localhost:3306/ai_agent_db\nELASTICSEARCH_HOST=http://localhost:9200\nOPENAI_API_KEY=your-openai-api-key\n```\n\n6. Jalankan migrasi database (jika menggunakan SQLAlchemy):\n\n```bash\nflask db init\nflask db migrate -m \"initial\"\nflask db upgrade\n```\n\n7. Jalankan server:\n\n```bash\nyarn install\nyarn run start\n```\n\n---\n\n## 🧠 Menjalankan AI Agent\n\nBuka:\n\n```\nhttp://localhost:5000/\n```\n\n---\n\n## 🐳 Jalankan via Docker\n\n```bash\ndocker-compose up --build\n```\n\n---\n\n## 🧪 Pengujian\n\n```bash\npytest tests/\n```\n\n---\n\n## 📌 Roadmap (Rencana Pengembangan)\n\n* [ ] Integrasi WebSocket untuk feedback agent secara real-time\n* [ ] Sistem RAG bawaan\n* [ ] Dukungan multiple backend memory (FAISS, Elastic, pgvector)\n\n---\n\n## Cara Membangun AGI dengan Soami\n\n[Tutorial bahasa Indonesia](documentation/tutorial.md)\n[Tutorial dalam Bahasa Inggris](documentation/tutorial_eng.md)\n\n---\n\n## 📄 Lisensi\n\nLisensi MIT\n\n---\n\n## 👨‍💻 Pengembang\n\nSaya mengembangkan framework ini untuk mempermudah proses membangun Semi AGI, didorong oleh semangat untuk menulis kode yang modular, fleksibel, dan berkelanjutan.\n\n## 🤝 Kontribusi dan Kontak\n\nEmail: [lahadiyani@gmail.com](mailto:lahadiyani@gmail.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flahadiyani%2Fsoami","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flahadiyani%2Fsoami","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flahadiyani%2Fsoami/lists"}