{"id":19778013,"url":"https://github.com/andrew-johnson-4/perplexity","last_synced_at":"2025-02-28T05:54:08.888Z","repository":{"id":103599685,"uuid":"485537124","full_name":"andrew-johnson-4/perplexity","owner":"andrew-johnson-4","description":"A notational semantic for documenting neural networks through diagrams","archived":false,"fork":false,"pushed_at":"2023-08-05T02:58:58.000Z","size":215,"stargazers_count":14,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-11T01:57:18.103Z","etag":null,"topics":["category-theory","diagramming","documentation","domain-specific-language","lambda-calculus","modelling","neural-network","visual-programming"],"latest_commit_sha":null,"homepage":"https://andrew-johnson-4.github.io/lsts-tutorial/","language":"HTML","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/andrew-johnson-4.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"github":"andrew-johnson-4","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2022-04-25T21:15:01.000Z","updated_at":"2024-09-02T18:32:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"2220fa71-e043-4c47-91c0-52d8950c4f9b","html_url":"https://github.com/andrew-johnson-4/perplexity","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrew-johnson-4%2Fperplexity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrew-johnson-4%2Fperplexity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrew-johnson-4%2Fperplexity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrew-johnson-4%2Fperplexity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andrew-johnson-4","download_url":"https://codeload.github.com/andrew-johnson-4/perplexity/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241108174,"owners_count":19910978,"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":["category-theory","diagramming","documentation","domain-specific-language","lambda-calculus","modelling","neural-network","visual-programming"],"created_at":"2024-11-12T05:27:26.523Z","updated_at":"2025-02-28T05:54:08.848Z","avatar_url":"https://github.com/andrew-johnson-4.png","language":"HTML","readme":"# Perplexity 😵\nThe Perplexity 😵 language is a notational semantic for documenting neural networks through diagrams.\n\n![MNIST Keras Python Perplexity](/img/mnist_keras_python_perplexity.png)\n\n# Scope\nThis visual language was created to help document neural networks.\nThe language may not be suitable to formally describe all characteristics of all possible neural network configurations.\n\n# Format\nThe Perplexity 😵 language consists of two languages: one [textual](/syntax.md), the other [visual](/syntax.md).\nThe visual language consists of two-dimensional images that can be created in Paint or other visual editors.\nThe textual language consists of [Typed Lambda Calculus expressions](https://andrew-johnson-4.github.io/lsts-tutorial/).\n\nAny file, textual or visual, defines a substitution rule according to its filename.\nFor example, a diagram \"helpful.png\" may be referred to as \"helpful\" in other textual language documentation.\n\n# Why?\nUML is not information dense enough and often leaves out important details. Mathematical Notation is too information dense and often repeats itself. Perplexity 😵 is created specifically to model Neural Networks and cuts a lot of corners by specializing itself for this use-case.\n\n# Checklist for Documenting a Model\n\n1. How many languages/algebras are you going to use in documentation?\n\u003e This determines the rank of your model. It is recommended to use different colored lines and circles\n\u003e when swapping between languages.\n\u003e For example, if you just want to document a TensorFlow model, then you only need Python and your model's rank will be 1.\n\n2. What prelude do you want to use?\n\u003e A prelude will include some terms that you then don't need to define again yourself. Each prelude defines its own ranks, kinds, types, values etc. Please consider using a prelude.\n\n# List of Preludes\nPreludes are optional-ish.\n- [Categorical Prelude](/categorical_prelude.md)\n- [TensorFlow Prelude](/tensorflow_prelude.md)\n","funding_links":["https://github.com/sponsors/andrew-johnson-4"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrew-johnson-4%2Fperplexity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandrew-johnson-4%2Fperplexity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrew-johnson-4%2Fperplexity/lists"}