{"id":24589431,"url":"https://github.com/simongino/file-manager","last_synced_at":"2026-04-13T16:35:16.344Z","repository":{"id":272855028,"uuid":"917598893","full_name":"SimonGino/file-manager","owner":"SimonGino","description":"A modern file management system with secure sharing, built with FastAPI and React. Features include file upload/download, password protection, expiration dates, and real-time updates. ","archived":false,"fork":false,"pushed_at":"2025-01-22T03:23:03.000Z","size":171,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-17T22:08:37.386Z","etag":null,"topics":["document-management","fastapi","file-management","file-sharing","react"],"latest_commit_sha":null,"homepage":"https://file.mytest.cc","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/SimonGino.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":"2025-01-16T09:45:01.000Z","updated_at":"2025-01-21T09:55:08.000Z","dependencies_parsed_at":"2025-01-17T02:34:45.983Z","dependency_job_id":"b6bf307e-6353-4d2a-a76a-8ffce4bad09f","html_url":"https://github.com/SimonGino/file-manager","commit_stats":null,"previous_names":["simongino/file-manager"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/SimonGino/file-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimonGino%2Ffile-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimonGino%2Ffile-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimonGino%2Ffile-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimonGino%2Ffile-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SimonGino","download_url":"https://codeload.github.com/SimonGino/file-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimonGino%2Ffile-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31761985,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T15:25:13.801Z","status":"ssl_error","status_checked_at":"2026-04-13T15:25:09.162Z","response_time":93,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["document-management","fastapi","file-management","file-sharing","react"],"created_at":"2025-01-24T08:15:47.739Z","updated_at":"2026-04-13T16:35:16.236Z","avatar_url":"https://github.com/SimonGino.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# File Manager\n\n[English](README.md) | [中文](README_zh.md)\n\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/simongino/file-manager/docker-build.yml?branch=main)](https://github.com/simongino/file-manager/actions)\n[![GitHub license](https://img.shields.io/github/license/simongino/file-manager)](https://github.com/simongino/file-manager/blob/main/LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/simongino/file-manager)](https://github.com/simongino/file-manager/stargazers)\n[![GitHub issues](https://img.shields.io/github/issues/simongino/file-manager)](https://github.com/simongino/file-manager/issues)\n\nA modern file management system built with FastAPI and React, featuring secure file sharing, access control, and real-time updates.\n\n## Features\n\n- 📁 File Management\n  - Upload, download, and organize files\n  - Support for multiple file types\n  - Drag and drop interface\n  - File preview\n\n- 🔒 Secure Sharing\n  - Generate shareable links\n  - Password protection option\n  - Expiration date setting\n  - Access control management\n\n- 👥 User Management\n  - User authentication\n  - Role-based access control\n  - Session management\n\n- 🚀 Modern Tech Stack\n  - Frontend: React + TypeScript + Ant Design\n  - Backend: FastAPI + Python\n  - Database: PostgreSQL\n  - Storage: MinIO\n  - Container: Docker\n\n## Prerequisites\n\n- Docker and Docker Compose\n- Node.js 20+ (for local development)\n- Python 3.11+ (for local development)\n- PostgreSQL 15+\n- MinIO\n\n## Quick Start\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/your-username/file-manager.git\ncd file-manager\n```\n\n2. Create necessary directories:\n```bash\nmkdir -p ~/middleware/postgres/data\nmkdir -p ~/middleware/minio/data\n```\n\n3. Create `.env` file in the root directory:\n```env\nDATABASE_URL=postgresql+asyncpg://root:123456@postgres:5432/doc_management\nMINIO_ENDPOINT=minio:9000\nMINIO_ACCESS_KEY=your_access_key\nMINIO_SECRET_KEY=your_secret_key\nMINIO_BUCKET_NAME=documents\nJWT_SECRET_KEY=your_jwt_secret\n```\n\n4. Start the services using Docker Compose:\n```bash\ndocker-compose up -d\n```\n\n5. Access the application:\n- Frontend: http://localhost:3000\n- Backend API: http://localhost:8000\n- MinIO Console: http://localhost:9001\n\n## Development Setup\n\n### Backend\n\n1. Install PDM:\n```bash\npip install pdm\n```\n\n2. Install dependencies:\n```bash\ncd backend\npdm install\n```\n\n3. Run the development server:\n```bash\npdm run python -m uvicorn src.main:app --reload\n```\n\n### Frontend\n\n1. Install dependencies:\n```bash\ncd frontend\nnpm install\n```\n\n2. Start the development server:\n```bash\nnpm run dev\n```\n\n## API Documentation\n\nOnce the backend is running, you can access the API documentation at:\n- Swagger UI: http://localhost:8000/docs\n- ReDoc: http://localhost:8000/redoc\n\n## Docker Images\n\nThe project uses Docker for containerization:\n\n- Backend: `ghcr.io/your-username/file-manager-backend:main`\n- Frontend: `ghcr.io/your-username/file-manager-frontend:main`\n\n## Project Structure\n\n```\n.\n├── frontend/                # React frontend application\n│   ├── src/\n│   │   ├── components/     # Reusable components\n│   │   ├── pages/         # Page components\n│   │   ├── utils/         # Utility functions\n│   │   └── types/         # TypeScript type definitions\n│   └── public/            # Static files\n│\n├── src/                    # FastAPI backend application\n│   ├── api/               # API routes\n│   ├── core/              # Core functionality\n│   ├── db/                # Database models and config\n│   ├── schemas/           # Pydantic models\n│   └── services/          # Business logic\n│\n├── docker/                # Docker related files\n├── .github/               # GitHub Actions workflows\n└── docker-compose.yml     # Docker Compose configuration\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\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## Acknowledgments\n\n- [FastAPI](https://fastapi.tiangolo.com/)\n- [React](https://reactjs.org/)\n- [Ant Design](https://ant.design/)\n- [MinIO](https://min.io/)\n- [PDM](https://pdm.fming.dev/)\n# file-manager\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimongino%2Ffile-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimongino%2Ffile-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimongino%2Ffile-manager/lists"}