{"id":25493798,"url":"https://github.com/sapiensdata/analytics","last_synced_at":"2025-11-09T03:30:23.567Z","repository":{"id":276616771,"uuid":"929761808","full_name":"SapiensData/analytics","owner":"SapiensData","description":"🚀 SapiensData Analytics – The AI-powered backend for data science, machine learning, and model training, to drive financial insights and IoT analytics.","archived":false,"fork":false,"pushed_at":"2025-02-09T10:47:37.000Z","size":32,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-02-09T13:23:59.880Z","etag":null,"topics":["data-science","iot","machine-learning","model-training","python"],"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/SapiensData.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":"2025-02-09T10:41:29.000Z","updated_at":"2025-02-09T12:47:14.000Z","dependencies_parsed_at":"2025-02-09T13:24:12.521Z","dependency_job_id":"1c84eb98-1a62-486a-b6ab-06c9ade63000","html_url":"https://github.com/SapiensData/analytics","commit_stats":null,"previous_names":["sapiensdata/analytics"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SapiensData%2Fanalytics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SapiensData%2Fanalytics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SapiensData%2Fanalytics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SapiensData%2Fanalytics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SapiensData","download_url":"https://codeload.github.com/SapiensData/analytics/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239565656,"owners_count":19660158,"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":["data-science","iot","machine-learning","model-training","python"],"created_at":"2025-02-18T23:17:27.237Z","updated_at":"2025-11-09T03:30:23.496Z","avatar_url":"https://github.com/SapiensData.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SapiensData.Analytics\n\n- Responsible for analytics and data processing, including AI models (Python) and data visualization (e.g. R).\n- Performs receipt analysis, OCR processes and financial reporting.\n\n## 📌 **Installation Guide**\n\n### **Prerequisites ✔️**\n\nBefore you begin, ensure you have the following installed on your machine:\n\n- Python 3.8 or higher\n- For your own .ENV:\n  - OpenAI API key\n  - Sapiens API key to connect to and authorize the SapiensDataAPI subproject (identical to your `SAPIENS_ANALYZER_SERVER_KEY` variable from `SapiensDataAPI/.env`)\n  - A Google Drive folder path\n  - For more information, see the `Analytics/.env.dev.example` file.\n\n### Go to the Analytics Subproject Folder\n\n`cd Analytics`\n\nRecommended: Open this path with vs code to select the Python interpreter in the IDE as the environment isolator method for this subproject only. The root and each subproject is better to open in vs code separately.\n\n## 🏆 **For Normal Users**\n\n### 1️⃣ **Create \u0026 Activate Virtual Environment**\n\n### **On macOS/Linux:**\n\n```bash\npython3 -m venv venv\nsource venv/bin/activate\n```\n\n### **On Windows:**\n\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\n```\n\n### 2️⃣ **Install Dependencies**\n\n📦 `pip install -r requirements.txt`\n\n### 3️⃣ **Set Up Environment Variables**\n\n📝 `cp .env.dev.example .env.dev`\n\n⚙️ **Edit `.env.dev` and configure your variables**\n\n### 4️⃣ **Run the Application**\n\n `python src/main.py`\n\n### 5️⃣ **Exit Virtual Environment (Optional)**\n\n🔚 `deactivate`\n\n## 👨‍💻 **For Contributors \u0026 Developers**\n\n### **1️⃣ Configure Git**\n\n```bash\ngit config user.name \"Your User Name\"\ngit config user.email \"your-email@example.com\"\n```\n\n### **2️⃣ Set Up Git Flow**\n\n```bash\ngit flow init\n```\n\n- Use **default settings** when prompted.\n\n### **3️⃣ Create \u0026 Activate Virtual Environment**\n\n### **On macOS/Linux:**\n\n```bash\npython3 -m venv venv\nsource venv/bin/activate\n```\n\n### **On Windows:**\n\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\n```\n\n### **4️⃣ Install Dependencies**\n\n```bash\npip install -r requirements.txt\n```\n\n### **5️⃣ Set Up Environment Variables**\n\n```bash\ncp .env.dev.example .env.dev\n```\n\n🛠️ **Edit `.env.dev` and set required values.**\n\n### **6️⃣ Create a New Feature Branch**\n\n```bash\ngit checkout develop  # Always start from the develop branch\ngit checkout -b feature/your-feature-name\n```\n\n### **7️⃣ Make Changes \u0026 Commit**\n\n```bash\ngit add .\ngit commit -m \"🔧 Add new feature: description\"\n```\n\n### **8️⃣ Push Changes \u0026 Create a Pull Request**\n\n```bash\ngit push origin feature/your-feature-name\n```\n\n🔄 **Go to GitHub and open a Pull Request (PR) to the `develop` branch.**\n\n---\n\n💡 **Tips for Contributors:**\n\n- Use `pip freeze \u003e requirements.txt` to update dependencies.\n- **Keep your branch updated** → `git pull origin develop`\n- **Follow commit message conventions**\n- **Use Git Flow for structured development**\n\n🚀 **Happy coding!** 🎉\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsapiensdata%2Fanalytics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsapiensdata%2Fanalytics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsapiensdata%2Fanalytics/lists"}