{"id":24986927,"url":"https://github.com/aixhunter/filewizardai","last_synced_at":"2025-10-16T11:06:35.294Z","repository":{"id":263336282,"uuid":"859292908","full_name":"AIxHunter/FileWizardAI","owner":"AIxHunter","description":"Add AI capabilities to your file system using Ollama, Groq, OpenAi and other's api","archived":false,"fork":false,"pushed_at":"2025-01-04T22:52:27.000Z","size":853,"stargazers_count":191,"open_issues_count":2,"forks_count":15,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-05-24T17:03:49.886Z","etag":null,"topics":["angular","filesystem","gpt-4","gpt-4o","groq","groq-api","hugging-face","huggingface","ia","linux","llm","ollama","ollama-api","openai","openai-api","python","python3","web","windows"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/AIxHunter.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":"2024-09-18T12:22:59.000Z","updated_at":"2025-05-18T02:08:45.000Z","dependencies_parsed_at":"2025-02-04T11:34:00.438Z","dependency_job_id":"f44c5d5b-d2c1-449a-b173-811d3ede0004","html_url":"https://github.com/AIxHunter/FileWizardAI","commit_stats":null,"previous_names":["aixhunter/filewizardai"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/AIxHunter/FileWizardAI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AIxHunter%2FFileWizardAI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AIxHunter%2FFileWizardAI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AIxHunter%2FFileWizardAI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AIxHunter%2FFileWizardAI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AIxHunter","download_url":"https://codeload.github.com/AIxHunter/FileWizardAI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AIxHunter%2FFileWizardAI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279181783,"owners_count":26121032,"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-10-16T02:00:06.019Z","response_time":53,"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":["angular","filesystem","gpt-4","gpt-4o","groq","groq-api","hugging-face","huggingface","ia","linux","llm","ollama","ollama-api","openai","openai-api","python","python3","web","windows"],"created_at":"2025-02-04T11:33:48.699Z","updated_at":"2025-10-16T11:06:35.263Z","avatar_url":"https://github.com/AIxHunter.png","language":"TypeScript","readme":"# FileWizardAI\n\n## Description\n\nFileWizardAI is a Python/Angular project designed to automatically organize your files into a well-structured directory\nhierarchy and rename them according to their content. This tool is ideal for anyone looking to declutter their digital\nworkspace by sorting files into appropriate folders and providing descriptive names, making it easier to manage and\nlocate files. Additionally, it allows you to input a text prompt and instantly searches for files that are related to\nyour query, providing you with the most relevant files based on the content you provide.\n\nThe app also features a caching system to minimize API calls, ensuring that only new or modified files are processed.\n\n### Example:\n\n**Before**\n\n```bash\n/home/user\n ├── Downloads\n │   ├── 6.1 Course Curriculum v2.pdf\n │   └── trip_paris.txt\n │   └── 8d71473c-533f-4ba3-9bce-55d3d9a6662a.jpg\n │   └── Screenshot_from_2024-06-10_21-39-24.png\n ```\n\n**After**\n\n```bash\n/home/user/Downloads\n ├─ docs\n │  └─ certifications\n │     └─ databricks\n │        └─ data_engineer_associate\n │           └─ curriculum_v2.pdf\n ├─ Personal Photos\n │  └─ 2024\n │     └─ 03\n │        └─ 01\n │           └─ person_in_black_shirt.jpg\n ├─ finance-docs\n │  └─ trip-expenses\n │     └─ paris\n │        └─ trip-justification.txt\n └─ project Assets\n    └─ instructions_screenshot.png\n```\n\n### Video tutorial:\n\n[![Watch the video](./yt_video_logo.png)](https://www.youtube.com/watch?v=T1rXLox80rM)\n\n\n## Table of Contents\n\n- [Installation](#installation)\n- [Usage](#usage)\n- [Run in Development Mode](#run-in-development-mode)\n- [Credits](#credits)\n- [License](#license)\n- [Technical architecture](#technical-architecture)\n\n## Installation\n\nMake sure you have Python installed on your machine.\n\nFirst, clone the repository:\n\n```bash\ngit clone https://github.com/AIxHunter/FileWizardAI.git\n```\n\nNavigate to the backend folder and update your `.env` file according to the [documentation](.env.md). Then, install the\nrequired\npackages by running ( preferably in a virtual environment like venv or conda):\n\n```bash\ncd backend\npip install -r requirements.txt\n```\n\n## Usage\n\nRun the backend server\n\n```bash\ncd backend\nuvicorn app.server:app --host localhost --port 8000\n```\n\nApp will be running under: http://localhost:8000/\n\n## Run in Development Mode\n\nIf you are a developper and you want to modify the frontend, you can run the frontend and backend separately, here is\nhow to do it:\nInstall Node.js https://nodejs.org/\n\ninstall Angular CLI:\n\n```bash\nnpm install -g @angular/cli\n```\n\nRun frontend:\n\n```bash\ncd frontend\nnpm install\nng serve\n```\n\nThe frontend will be available at `http://localhost:4200`.\n\nto package the frontend run:\n\n```bash\nng build --base-href static/\n```\n\nRun backend:\n\nUpdate your `.env` file with the desired API settings (check the [documentation](.env.md)), then:\n\n```bash\ncd backend\nuvicorn app.server:app --host localhost --port 8000 --reload\n```\n\n## Technical architecture\n\n\u003cimg src=\"filewizardai_architecture.png\" alt=\"Online Image\" width=\"600\"/\u003e\n\n1. Send request from Angular frontend (ex, organize files)\n2. Backend receives request through a REST API of FastAPI.\n3. Check SQLite if files has already been processed (cached files).\n4. Return cached summary if file was already processed.\n5. If the file has not been processed before, send new file to LLM for summarization.\n6. Cache summary in SQLite.\n7. Return summary to Angular frontend.\n8. Display summary to user and perform actions if need it.\n\n## License\n\nThis project is licensed under the MIT License.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faixhunter%2Ffilewizardai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faixhunter%2Ffilewizardai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faixhunter%2Ffilewizardai/lists"}