{"id":43171962,"url":"https://github.com/opencitations/cec","last_synced_at":"2026-02-01T02:35:40.790Z","repository":{"id":210668823,"uuid":"726032581","full_name":"opencitations/cec","owner":"opencitations","description":"Citation Extraction and Classifier","archived":false,"fork":false,"pushed_at":"2026-01-14T16:13:09.000Z","size":348059,"stargazers_count":15,"open_issues_count":2,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-01-14T17:57:03.600Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/opencitations.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-12-01T11:46:02.000Z","updated_at":"2026-01-12T07:29:47.000Z","dependencies_parsed_at":"2024-01-22T10:55:28.035Z","dependency_job_id":"95c35432-b961-4651-878f-2439daca3b03","html_url":"https://github.com/opencitations/cec","commit_stats":null,"previous_names":["opencitations/cec"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/opencitations/cec","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opencitations%2Fcec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opencitations%2Fcec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opencitations%2Fcec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opencitations%2Fcec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opencitations","download_url":"https://codeload.github.com/opencitations/cec/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opencitations%2Fcec/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28965430,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T02:14:24.993Z","status":"ssl_error","status_checked_at":"2026-02-01T02:13:55.706Z","response_time":56,"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":[],"created_at":"2026-02-01T02:35:40.726Z","updated_at":"2026-02-01T02:35:40.780Z","avatar_url":"https://github.com/opencitations.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Citation Extractor and Classifier\n\nThe Citation Extractor and Classifier is  a software that performs the automatic annotation of in-text citations in academic papers provided in PDF. \n\nIt is developed within the [GraspOS EU project](https://graspos.eu/). \n\n\nIt works by applying two steps, described as follows:\n\n- ___PDF Parsing___. The software analyses the PDF paper provided as input and extracts its basic bibliographic metadata, all the bibliographic references with all its metadata marked up, the citation sentences that contain in-text reference pointers , and other structural information such as sections, when possible\n- ___Citation Function Classification___. The software uses the output of the previous step to classify the semantics emerging from each citation sentence that will be used for characterising the function of the citation defined by the authors of the citing paper (i.e., the input PDF) by means of the related in-text reference pointer.\n\nPlease find more details in the README files of each module: [extractor](extractor/README.md) and [classifier](classifier/README.md).\n\n\n# Docker Compose\nReady-to-use Docker setup. No expertise required.\n\nCreate `docker-compose.yaml`:\n```yaml\nservices:\n  grobid:\n    image: opencitations/grobid-cec:1.0.0\n    container_name: grobid\n    init: true\n    ports:\n      - \"8070:8070\"\n    deploy:\n      resources:\n        limits:\n          memory: 16G\n          cpus: '4'\n        reservations:\n          memory: 8G\n          cpus: '2'\n    restart: unless-stopped\n\n  extractor:\n    image: opencitations/oc_cec_extractor:1.0.4\n    container_name: cec_extractor\n    init: true\n    ports:\n      - \"5001:5001\"\n    deploy:\n      resources:\n        limits:\n          memory: 16G\n        reservations:\n          memory: 2G\n    environment:\n      - GROBID_URL=http://grobid:8070\n    restart: unless-stopped\n    depends_on:\n      - grobid\n\n  cic-classifier:\n    image: opencitations/oc_cec_classifier:V2_full\n    container_name: cic-classifier\n    ports:\n      - \"5000:5000\"\n    deploy:\n      resources:\n        limits:\n          memory: 16G\n        reservations:\n          memory: 4G\n    restart: unless-stopped\n```\n\n**Adjust CPU and RAM based on your hardware.**\n\n## Commands\n```bash\ndocker compose up -d      # Run the docker-compose.yaml\ndocker compose down       # Stop all the containers\ndocker compose restart    # Restart all\n```\n\n## Services\n\n- Classifier: http://localhost:5000/cic\n- Extractor: http://localhost:5001/cex","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopencitations%2Fcec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopencitations%2Fcec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopencitations%2Fcec/lists"}