{"id":25666437,"url":"https://github.com/ascender1729/vodafone-financial-analysis","last_synced_at":"2026-05-19T10:39:29.174Z","repository":{"id":278976191,"uuid":"937372151","full_name":"ascender1729/vodafone-financial-analysis","owner":"ascender1729","description":"Automated financial table extraction and standardization from Vodafone's annual report using GPT-4o-mini","archived":false,"fork":false,"pushed_at":"2025-02-22T22:47:33.000Z","size":816,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-03T13:57:25.378Z","etag":null,"topics":["automation","balance-sheet","crediflow-ai","csv","financial-analysis","financial-tables","gpt-4o-mini","machine-learning","ocr","openai","pandas","pdf-extraction","pdf2image","pypdf2","pytesseract","standardization","striprtf","vodafone"],"latest_commit_sha":null,"homepage":"https://github.com/ascender1729/vodafone-financial-analysis","language":"Rich Text Format","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/ascender1729.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-02-22T22:16:21.000Z","updated_at":"2025-02-23T18:15:46.000Z","dependencies_parsed_at":"2025-02-22T23:25:33.068Z","dependency_job_id":"1905ee5d-286e-4055-8ad8-93637f3fe67f","html_url":"https://github.com/ascender1729/vodafone-financial-analysis","commit_stats":null,"previous_names":["ascender1729/vodafone-financial-analysis"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ascender1729/vodafone-financial-analysis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ascender1729%2Fvodafone-financial-analysis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ascender1729%2Fvodafone-financial-analysis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ascender1729%2Fvodafone-financial-analysis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ascender1729%2Fvodafone-financial-analysis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ascender1729","download_url":"https://codeload.github.com/ascender1729/vodafone-financial-analysis/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ascender1729%2Fvodafone-financial-analysis/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265198349,"owners_count":23726447,"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":["automation","balance-sheet","crediflow-ai","csv","financial-analysis","financial-tables","gpt-4o-mini","machine-learning","ocr","openai","pandas","pdf-extraction","pdf2image","pypdf2","pytesseract","standardization","striprtf","vodafone"],"created_at":"2025-02-24T08:30:13.216Z","updated_at":"2026-05-19T10:39:29.140Z","avatar_url":"https://github.com/ascender1729.png","language":"Rich Text Format","funding_links":[],"categories":[],"sub_categories":[],"readme":"# vodafone-financial-analysis\n\u003e Automated financial table extraction and standardization from Vodafone's annual report using GPT-4o-mini\n\n## Table of Contents\n- [Overview](#overview)\n- [Project Structure](#project-structure)\n- [Features](#features)\n- [Solution Architecture](#solution-architecture)\n- [Usage](#usage)\n- [Implementation Details](#implementation-details)\n- [Results](#results)\n- [Future Enhancements](#future-enhancements)\n- [License](#license)\n\n## Overview\nThis project automates the extraction and standardization of financial tables from Vodafone's annual report using GPT-4o-mini. Developed for the Crediflow AI Assignment, it addresses:\n\n1. Extraction of financial tables from PDF report\n2. Standardization of Balance Sheet terminology\n3. Future optimization proposals\n\n## Project Structure\n```\nvodafone-financial-analysis/\n├── extracted_data/                 \n│   ├── extracted_text.txt           # Raw extracted text\n│   ├── extraction_validation.log    # Validation logs\n│   └── processed_vocabulary.json    # Processed vocabulary terms\n├── financial_tables/\n│   ├── INCOME_STATEMENT.csv\n│   ├── STATEMENT_OF_COMPREHENSIVE_INCOME.csv\n│   ├── STATEMENT_OF_FINANCIAL_POSITION.csv\n│   └── financial_tables.md\n├── standardized_output/\n│   ├── standardized_balance_sheet.csv\n│   └── standardized_balance_sheet.md\n├── input/\n│   ├── vocabulary.rtf              # Vocabulary list\n│   └── vodafone_annual_report.pdf  # Source PDF\n├── docs/\n│   ├──  workflow.svg                # Solution workflow diagram\n│   └── Crediflow_AI_Assignment.ipynb \n└── README.md\n```\n\n## Features\n- PDF text extraction with OCR fallback\n- GPT-4o-mini powered table identification\n- Financial term standardization\n- Multiple output formats (Markdown, CSV)\n- Detailed validation and logging\n\n## Solution Architecture\n\n[//]: # \"Insert workflow diagram here\"\n![Solution Workflow](docs/workflow.svg)\n\n## Usage\n[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1hrjoKFIDsxRZfuGJYMr_vTO_YlUR3wXd?usp=sharing)\n\n### Quick Start\n1. Add input files from `/input` directory to the notebook\n2. Run text extraction notebook\n3. Process financial tables\n4. Check outputs in respective directories\n\n## Implementation Details\n\n### Question 1: Table Extraction\nSuccessfully extracted three financial tables:\n\n| Table Type | Status | Output Location |\n|------------|--------|-----------------|\n| Income Statement | ✅ | financial_tables/INCOME_STATEMENT.csv |\n| Balance Sheet | ✅ | financial_tables/STATEMENT_OF_FINANCIAL_POSITION.csv |\n| Comprehensive Income | ✅ | financial_tables/STATEMENT_OF_COMPREHENSIVE_INCOME.csv |\n\n### Question 2: Balance Sheet Standardization\nImplemented term standardization using:\n- GPT-4o-mini for semantic matching\n- Predefined vocabulary from RTF file\n- Structure preservation\n- Numerical accuracy validation\n\nResults available in:\n- standardized_output/standardized_balance_sheet.csv\n- standardized_output/standardized_balance_sheet.md\n\n### Question 3: Future Optimizations\n\n#### Technical Improvements\n- Batch processing capabilities\n- Enhanced error handling\n- Improved OCR accuracy\n\n#### Feature Additions\n- Support for multiple file formats\n\n#### Quality Enhancements\n- Comprehensive validation\n- Performance optimization\n- Enhanced logging\n- Better error reporting\n\n## Results\nSuccessfully processed Vodafone's annual report with:\n- Three financial tables extracted\n- Standardized Balance Sheet terminology\n- Structured outputs in CSV and MD formats\n- Preserved numerical accuracy\n- Maintained hierarchical relationships\n\n## Dependencies\n- Python 3.8+\n- OpenAI API access\n- Required libraries:\n  ```\n  pytesseract\n  pdf2image\n  PyPDF2\n  pandas\n  openai\n  striprtf\n  ```\n\n## License\nMIT License\n\n  ```\nCreated as part of the Crediflow AI Assignment\n  ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fascender1729%2Fvodafone-financial-analysis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fascender1729%2Fvodafone-financial-analysis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fascender1729%2Fvodafone-financial-analysis/lists"}