{"id":28088909,"url":"https://github.com/engkinandatama/ncbi-sequence-fetcher","last_synced_at":"2025-07-23T04:35:58.062Z","repository":{"id":292927743,"uuid":"982395456","full_name":"engkinandatama/NCBI-Sequence-Fetcher","owner":"engkinandatama","description":"NCBI Sequence Fetcher is a Python desktop app for downloading nucleotide sequences and extracting metadata from NCBI. It features an easy-to-use GUI, supports FASTA and GenBank formats, and helps researchers students and bioinformaticians efficiently collect DNA sequences and store metadata in Excel files.","archived":false,"fork":false,"pushed_at":"2025-05-13T06:10:31.000Z","size":27,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-13T12:59:40.411Z","etag":null,"topics":["academic","bioinformatics","bioinformatics-tool","data-scraping","fasta","genbank","metadata","metadata-extraction","molecular-biology","ncbi","nucleotide-sequences","python","tkinter"],"latest_commit_sha":null,"homepage":"","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/engkinandatama.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,"zenodo":null}},"created_at":"2025-05-12T20:21:40.000Z","updated_at":"2025-05-13T06:10:35.000Z","dependencies_parsed_at":"2025-05-12T21:42:41.198Z","dependency_job_id":"90dfe33a-a7fa-433b-9048-073c63a00074","html_url":"https://github.com/engkinandatama/NCBI-Sequence-Fetcher","commit_stats":null,"previous_names":["engkinandatama/ncbi-sequence-fetcher"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/engkinandatama/NCBI-Sequence-Fetcher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engkinandatama%2FNCBI-Sequence-Fetcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engkinandatama%2FNCBI-Sequence-Fetcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engkinandatama%2FNCBI-Sequence-Fetcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engkinandatama%2FNCBI-Sequence-Fetcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/engkinandatama","download_url":"https://codeload.github.com/engkinandatama/NCBI-Sequence-Fetcher/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/engkinandatama%2FNCBI-Sequence-Fetcher/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266618971,"owners_count":23957273,"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-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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":["academic","bioinformatics","bioinformatics-tool","data-scraping","fasta","genbank","metadata","metadata-extraction","molecular-biology","ncbi","nucleotide-sequences","python","tkinter"],"created_at":"2025-05-13T12:52:22.769Z","updated_at":"2025-07-23T04:35:58.038Z","avatar_url":"https://github.com/engkinandatama.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧬 NCBI Sequence Fetcher\n\nA lightweight and user-friendly desktop application for downloading nucleotide sequences and extracting biological metadata directly from NCBI.  \nBuilt with Python and Tkinter, designed for researchers, students, and bioinformaticians.\n\n---\n\n### ⚠️ **Note**:\n\u003e **This repository is for personal and educational use only.**  \n\u003e It is not currently open for external collaboration or contribution.  \n\u003e Please use responsibly and cite NCBI appropriately when using downloaded data.\n\n---\n\n## 📸 GUI Preview\n\nComing soon — stay tuned!\n\n---\n\n## ✨ Features\n\n- 🔗 **Direct URL Input**: Download GenBank/FASTA files from any valid NCBI nuccore link.\n- 📁 **FASTA / GenBank Format Support**: Choose your preferred sequence format.\n- 🧬 **Automatic Metadata Extraction**:\n  - Accession, Organism, Strain, Taxonomy, Country, Collection Date, Length, etc.\n- 📄 **Excel Export**:\n  - All metadata saved in a clean Excel file (`ncbi_metadata.xlsx`)\n- 🏷️ **Smart File Naming**:\n  - Files saved with informative names: `Organism_Strain_Accession_Length_Feature.fasta`\n- 🖥️ **GUI Based**:\n  - No command line needed; simple Tkinter-based interface.\n\n---\n\n## 🛠️ Technologies Used\n\n- **Language**: Python 3.8+\n- **Libraries**:\n  - `requests`\n  - `pandas`\n  - `openpyxl`\n  - `tkinter` (built-in)\n\n---\n\n## 🚀 Installation \u0026 Usage\n\n### 🔧 Step 1: Clone the repository\n\n```bash\ngit clone https://github.com/engkinandatama/NCBI-Sequence-Fetcher.git\n```\n```\ncd ncbi-data-scraper\n```\n### 📦 Step 2: Install dependencies\n```\npip install -r requirements.txt\n```\n### ▶️ Step 3: Run the app\n```\npython ncbi_scraper.py\n```\n\n---\n\n## 🧪 How It Works\n\n1. **Paste a valid NCBI URL**  \n   Example:  https://www.ncbi.nlm.nih.gov/nuccore/JN188370.1\n\n2. **Choose the format**  \n`fasta` or `genbank`\n\n3. **Select a destination folder**  \nWhere the sequence file and Excel metadata will be saved\n\n4. **Click `Download`**\n\n---\n\n### 🔄 Behind the Scenes:\n\nThe app will:\n\n- 🔍 **Fetch** the nucleotide data directly from NCBI\n- 💾 **Save** the sequence locally as: `.fasta` if FASTA format is selected, `.gb` (GenBank) if GenBank format is selected\n- 🧬 **Parse and extract metadata**: Accession, Organism, Strain, Country, Date, and more\n- 📊 **Append** the metadata into an Excel file: `ncbi_metadata.xlsx`\n\n\n---\n\n## 📁 Output Example\n\nSetelah proses selesai, file output akan tersimpan seperti berikut:\n```\n📂 Output_Folder/\n├── Escherichia_coli_K12_JN188370.1_4500bp_partial_cds.fasta\n└── ncbi_metadata.xlsx\n```\n- **FASTA / GenBank File**: Berisi urutan nukleotida yang diunduh dari NCBI.\n- **ncbi_metadata.xlsx**: File Excel yang berisi metadata terstruktur dari setiap entri GenBank yang diunduh.\n\n\n---\n\n## 📜 License\n\nThis project is licensed under the **MIT License**.\n\n\u003e **Disclaimer**:  \n\u003e This tool is developed solely for **academic and personal research purposes**.  \n\u003e Commercial use, bulk data scraping, or redistribution of NCBI content may **violate NCBI's usage policies** and is **strongly discouraged**.  \n\u003e  \n\u003e The developer **does not take any responsibility** for misuse, legal issues, or policy violations resulting from the use of this tool.  \n\u003e **Users are fully responsible** for ensuring their usage complies with relevant terms, laws, and guidelines.  \n\u003e  \n\u003e See [NCBI's policies](https://www.ncbi.nlm.nih.gov/home/about/policies/) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fengkinandatama%2Fncbi-sequence-fetcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fengkinandatama%2Fncbi-sequence-fetcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fengkinandatama%2Fncbi-sequence-fetcher/lists"}