{"id":16681633,"url":"https://github.com/tetigi/kartka","last_synced_at":"2025-09-30T15:32:23.819Z","repository":{"id":149487459,"uuid":"322931522","full_name":"tetigi/kartka","owner":"tetigi","description":"Kartka is a tool for people who hate paper.","archived":true,"fork":false,"pushed_at":"2025-02-14T20:37:02.000Z","size":36,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-13T10:30:33.592Z","etag":null,"topics":["indexing","paper","tool"],"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/tetigi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2020-12-19T20:23:01.000Z","updated_at":"2025-02-14T20:37:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"592c8ad1-2a5c-4302-bf8f-aee1ac476866","html_url":"https://github.com/tetigi/kartka","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/tetigi/kartka","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tetigi%2Fkartka","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tetigi%2Fkartka/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tetigi%2Fkartka/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tetigi%2Fkartka/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tetigi","download_url":"https://codeload.github.com/tetigi/kartka/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tetigi%2Fkartka/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277712808,"owners_count":25864430,"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-09-30T02:00:09.208Z","response_time":75,"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":["indexing","paper","tool"],"created_at":"2024-10-12T14:04:50.298Z","updated_at":"2025-09-30T15:32:23.808Z","avatar_url":"https://github.com/tetigi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Archived\n\nCheck out the [new, better version instead](https://github.com/tetigi/kartka_rs/tree/develop).\n\n---\n\n# Kartka #\n\nKartka is a tool for people who hate paper. It provides a workflow for scanning, indexing, and then uploading letters\nyou receive for later retrieval.\n\nKartka uses (your own) Google Drive for storage, and Sonic for efficient and simple indexing.\n\n## How it works ##\n\n```buildoutcfg\nKartka\n\npositional arguments:\n  {check,ingest,scan,search,hydrate}\n                        The mode to use\n    check               check connections\n    ingest              ingest a letter\n    scan                start a scan \n    search              search for letters\n    hydrate             hydrate sonic from drive\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --config CONFIG       Kartka configuration file location\n```\n\n`./kartka.py ingest scan_page_1.png scan_page_2.png`\n\n```text\n\u003e ./kartka.py search mortgage\n\n2020-12-22 1512  -\u003e https://drive.google.com/file/d/\u003cid\u003e/view?usp=sharing\n2020-11-18 1048  -\u003e https://drive.google.com/file/d/\u003cid\u003e/view?usp=sharing\n2020-11-12 1142  -\u003e https://drive.google.com/file/d/\u003cid\u003e/view?usp=sharing\n```\n\nThere are 3 basic commands:\n\n`ingest`: Ingest one or more files from the command line, index them, and then upload them.\n\n`scan`: Begin a 'scan' workflow where you can scan your pages into a configured directory, and then ingest once finished.\n\n`search`: Search for letters that contain all of the provided keywords. Supports search suggestions via autocomplete.\n\n## Installation ##\n\nTo use `kartka`, you will need the following:\n\n- A functioning Sonic instance: https://github.com/valeriansaliou/sonic\n- Tesseract OCR: https://github.com/madmaze/pytesseract#installation\n- Install the python `requirements.txt`, via a venv or otherwise: \n  https://pip.pypa.io/en/stable/user_guide/#requirements-files\n  \n- A drive-enabled `credentials.json`: I use https://developers.google.com/drive/api/v3/quickstart/python because I'm lazy.\n\nThen copy `kartka.cfg.example` to `kartka.cfg` and configure it with your preferred settings. I personally like to run\nmy Sonic instance on a Raspberry Pi (for convenience), but it can be ran locally as well.\n\nMove the `credentials.json` to your `data_dir` (configured in the `cfg` above).\n\nNow you're ready to go! On first run `kartka` will run the auth-flow on your new drive-app. After this, it will re-use\nthe stored token.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftetigi%2Fkartka","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftetigi%2Fkartka","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftetigi%2Fkartka/lists"}