{"id":16602414,"url":"https://github.com/lnxpy/sighted","last_synced_at":"2025-08-09T14:23:43.811Z","repository":{"id":249544881,"uuid":"827291838","full_name":"lnxpy/sighted","owner":"lnxpy","description":"NLP approach for enhancing your reading quality!","archived":false,"fork":false,"pushed_at":"2024-07-21T17:39:35.000Z","size":12916,"stargazers_count":16,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-15T23:56:20.232Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://sighted.vercel.app/","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/lnxpy.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":"2024-07-11T11:13:16.000Z","updated_at":"2025-03-29T16:09:53.000Z","dependencies_parsed_at":"2024-07-21T19:08:54.441Z","dependency_job_id":null,"html_url":"https://github.com/lnxpy/sighted","commit_stats":null,"previous_names":["lnxpy/sighted"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/lnxpy/sighted","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnxpy%2Fsighted","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnxpy%2Fsighted/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnxpy%2Fsighted/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnxpy%2Fsighted/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lnxpy","download_url":"https://codeload.github.com/lnxpy/sighted/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnxpy%2Fsighted/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269587179,"owners_count":24442724,"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-08-09T02:00:10.424Z","response_time":111,"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":[],"created_at":"2024-10-12T00:22:04.259Z","updated_at":"2025-08-09T14:23:43.770Z","avatar_url":"https://github.com/lnxpy.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Sighted - Your brain reads faster than your eyes!\nUsing NLP and bionic AI algorithms to help you stay focused and not get distracted when reading.\n\n- [Sighted is LIVE here!](https://sighted.vercel.app)\n- [See how Sighted can be helpful for individuals with Dyslexia and ADHD who love reading books!](#adhd--dyslexia)\n\n### Installation\n```sh\npip install sighted\n```\n\nSighted uses a very light (~12Mb) pre-trained model that works perfectly fine with normal text inputs.\n\n### Usage\n```python\nfrom sighted import Literal\nfrom sighted.language import PoS\n\nfrom string import Template\n\n\ntext = \"Hello there. This is an experimental text to showcase \\\n        how fast you can read with Sighted.\"\n\nlanguage = Literal(\n    text=text, \n    fixation=2,\n    saccade=2,\n    ignore_pos=[PoS.PUNCT]  # ignoring punctuations\n)  \n\ntransformed_text = language.transform(\n    template=Template(' \u003cspan class=\"$pos\" id=\"$dep\"\u003e\u003cb\u003e$fix\u003c/b\u003e$unfix\u003c/span\u003e')\n)\n```\n\nThe `transformed_text` is an iterable that contains the following items:\n\n```html\n\u003cspan class=\"intj\" id=\"ROOT\"\u003e\u003cb\u003eHe\u003c/b\u003ello\u003c/span\u003e\n\u003cspan class=\"adv\" id=\"advmod\"\u003e\u003cb\u003eth\u003c/b\u003eere\u003c/span\u003e\n. \u003c!-- Look how this punctuation is ignored --\u003e\n\u003cspan class=\"pron\" id=\"nsubj\"\u003e\u003cb\u003eTh\u003c/b\u003eis\u003c/span\u003e\n\u003cspan class=\"aux\" id=\"ROOT\"\u003e\u003cb\u003ei\u003c/b\u003es\u003c/span\u003e\n\u003cspan class=\"det\" id=\"det\"\u003e\u003cb\u003ea\u003c/b\u003en\u003c/span\u003e\n\u003cspan class=\"adj\" id=\"amod\"\u003e\u003cb\u003eexper\u003c/b\u003eimental\u003c/span\u003e\n\u003cspan class=\"noun\" id=\"attr\"\u003e\u003cb\u003ete\u003c/b\u003ext\u003c/span\u003e\n\u003cspan class=\"part\" id=\"aux\"\u003e\u003cb\u003et\u003c/b\u003eo\u003c/span\u003e\n\u003cspan class=\"verb\" id=\"relcl\"\u003e\u003cb\u003eshow\u003c/b\u003ecase\u003c/span\u003e\n\u003cspan class=\"space\" id=\"dep\"\u003e\u003cb\u003e    \u003c/b\u003e    \u003c/span\u003e\n\u003cspan class=\"sconj\" id=\"advmod\"\u003e\u003cb\u003eho\u003c/b\u003ew\u003c/span\u003e\n\u003cspan class=\"adv\" id=\"advmod\"\u003e\u003cb\u003efa\u003c/b\u003est\u003c/span\u003e\n\u003cspan class=\"pron\" id=\"nsubj\"\u003e\u003cb\u003eyo\u003c/b\u003eu\u003c/span\u003e\n\u003cspan class=\"aux\" id=\"aux\"\u003e\u003cb\u003eca\u003c/b\u003en\u003c/span\u003e\n\u003cspan class=\"verb\" id=\"ccomp\"\u003e\u003cb\u003ere\u003c/b\u003ead\u003c/span\u003e\n\u003cspan class=\"adp\" id=\"prep\"\u003e\u003cb\u003ewi\u003c/b\u003eth\u003c/span\u003e\n\u003cspan class=\"propn\" id=\"pobj\"\u003e\u003cb\u003eSig\u003c/b\u003ehted\u003c/span\u003e\n. \u003c!-- Look how this punctuation is ignored --\u003e\n```\n\nIf you place this content within a `\u003cp/\u003e` tag in a very basic HTML `\u003cbody/\u003e` structure, you'll have this kind of UI.\n\n\n![Basic result](media/img1.png)\n\nSince you have used `$pos` and `$dep` to set unique `class` and `id` to each word, you now have full control over their styling.\n\n```css\n/* unfixed letters */\np { color: gray; }\n\n/* fixed letters */\nb { color: black; }\n\n/* adverbs */\n.adv { border-bottom: solid 1px; }\n\n/* pronouns */\n.pron { color: red; }\n.pron \u003e b { color: purple; }\n\n/* verbs */\n.verb {\n    background-color: yellow;\n    padding: 3px;\n    border-radius: 2px;\n}\n```\n\nNow, you see how that basic CSS styling declaration has affected the text.\n\n![Basic result](media/img2.png)\n\n### Fixation\nThis parameter indicates how many first letters from each word should be considered as fixation. It's a value between 1 to 5. As you increase it, you see that the amount of fixed letters (bolded letters) will increase from the beginning of each word.\n\n![Basic result](media/img3.png)\n\n### Saccade\nSaccades are rapid, involuntary eye movements that play a crucial role in reading by allowing the eyes to jump quickly from one word or section of text to another. In bionic reading, a technique designed to enhance reading efficiency, saccades are optimized by strategically highlighting certain letters or parts of words to guide the reader’s gaze. This method reduces the cognitive load on the brain by making it easier to recognize and process words, thereby improving reading speed and comprehension. By leveraging the natural mechanics of saccades, Sighted can make the reading experience smoother and more intuitive, particularly for individuals with reading difficulties.\n\n![Basic result](media/img4.png)\n\n![Basic result](media/img5.png)\nImage credits: ResearchGate\n\n### ADHD \u0026 Dyslexia\nSighted aids individuals with dyslexia by highlighting the first few letters of words, enhancing pattern recognition and reducing the cognitive effort needed for word decoding. For those with ADHD (Attention Deficit Hyperactivity Disorder), this technique helps maintain focus and improves reading fluency by guiding the eyes and reducing distractions within the text.\n\n### License\nMIT","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flnxpy%2Fsighted","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flnxpy%2Fsighted","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flnxpy%2Fsighted/lists"}