{"id":30294444,"url":"https://github.com/linkedin/forthic","last_synced_at":"2025-08-17T01:35:00.128Z","repository":{"id":40383216,"uuid":"373570133","full_name":"linkedin/forthic","owner":"linkedin","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-28T20:27:32.000Z","size":6964,"stargazers_count":25,"open_issues_count":0,"forks_count":6,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-07-27T18:21:39.545Z","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":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/linkedin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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,"zenodo":null}},"created_at":"2021-06-03T16:16:22.000Z","updated_at":"2025-06-28T20:27:37.000Z","dependencies_parsed_at":"2023-12-22T16:37:50.031Z","dependency_job_id":"7f14e792-1eb5-4243-bcbf-119743c27ced","html_url":"https://github.com/linkedin/forthic","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/linkedin/forthic","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linkedin%2Fforthic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linkedin%2Fforthic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linkedin%2Fforthic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linkedin%2Fforthic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/linkedin","download_url":"https://codeload.github.com/linkedin/forthic/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linkedin%2Fforthic/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270796217,"owners_count":24647319,"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-16T02:00:11.002Z","response_time":91,"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":"2025-08-17T01:34:59.421Z","updated_at":"2025-08-17T01:35:00.067Z","avatar_url":"https://github.com/linkedin.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Forthic\n\nForthic is a stack-based language for making apps tweakable.\n\nBy embedding a Forthic interpreter in your application, you can make apps tweakable at runtime, even by end users.\nLinkedIn has used this approach to build hundreds of internal Jira-based program management tools.\n\nThis repository contains two primary Forthic interpreters: a Python-based based one that can run within a Flask app in order to create\nAPIs that can be revised at runtime and a React-based one that can create user interfaces on-the-fly.\n\n## Documentation\n\nFor a brief overview of Forthic, see [OVERVIEW.md](docs/OVERVIEW.md).\nThe [SYNTAX.md](docs/SYNTAX.md) file shows what the language looks like, including a brief overview of some of the standard global Forthic words.\nThe [IDIOMS.md](docs/IDIOMS.md) file gives pointers on how to use Forthic the way it was designed to be used.\nThe [ARCHITECTURE.md](docs/ARCHITECTURE.md) file shows how Forthic interpreters can work within apps.\n\nForthic modules are documented in the [modules](./forthic-py/docs/)\n\n### YouTube\n\nThere are several YouTube videos for learning Forthic\n\n-   [Coding Forthic with Rino](https://www.youtube.com/@codingforthic) goes over some of the example applications\n-   [Learning Forthic](https://www.youtube.com/playlist?list=PLSnCkfp4FIBQJEM9SNeGLjt_VrPrHMzQF) teaches Forthic using [Forthix Jira Plugins](https://marketplace.atlassian.com/vendors/1225195/forthix-llc) and Jupyter notebooks.\n\n### Articles\n\n-   [Forthic How To](https://forthix.com/category/how-to/)\n-   [LinkedIn Article on how to use the Jira module](https://www.linkedin.com/pulse/hello-forthic-abdul-sheik)\n-   [Categorical Coding](https://forthix.com/category/categorical-coding/)\n\n## Getting started\n\nTo get started, you can run an example Flask server with an embedded Forthic interpreter that\nalso serves React apps with embedded Forthic interpreters.\n\n### Starting the example server\n\n```\n# On Mac and Linux\nmake\n\n# On Windows\n.\\make-install.ps1\n.\\make-server.ps1\n```\n\nThis creates a Python virtual environment, installs Forthic into it, and runs a\nweb server on [http://localhost:8000](http://localhost:8000)\n\nSee [EXAMPLES.md](docs/EXAMPLES.md) for more information.\n\n### Deleting secrets\n\nSome examples require credentials in order to work (e.g., Jira username and password/api-token).\nThe example server stores these on your computer as an encrypted in a JSON object in the `server/.secrets` file. To delete a particular secret, just remove it from this file and save. To delete all secrets along with the encryption key, delete `server/.secrets` and `server/.key` or\n\n```\n# On Mac and Linux\nmake delete-secrets\n\n# On Windows\nmake-delete-secrets.ps1\n```\n\n## Tests\n\nEach Forthic interpreter variant has its own test suite. To run the primary tests for `forthic-py` and `forthic-react` just run\n\n```\nmake test\n```\n\n## Experimental Interpreters\n\nIn addition to the primary interpreters for Python and React, there are a number of experimental interpreters that\nshow how Forthic can be implemented in other languages.\nThose who like learning different programming languages might find it interesting to compare the different implementations.\nThese proto-implementations can also serve as starting points for complete Forthic interpreters.\n\n| Host Language                         | Comments                                                                                   |\n| ------------------------------------- | ------------------------------------------------------------------------------------------ |\n| [TypeScript](./forthic-ts/)           | Essentially complete and available on NPM at [@forthic/interp](https://www.npmjs.com/package/@forthic/interp) |\n| [Ruby](./forthic-rb/)                 | Essentially complete|\n| [C++](./experimental/forthic-cpp/)    | Proof of concept using C++ in .NET                                                         |\n| [Haskell](./experimental/forthic-hs)  | An experiment to see if a Forthic interpreter could be built in a pure functional language |\n| [Julia](./experimental/forthic-jl)    | Proof of concept in Julia                                                                  |\n| [nvcc](./experimental/forthic-nvcc)   | Proof of concept for building a interpreter that could run on GPUs via CUDA                |\n| [swift](./experimental/forthic-swift) | An attempt to build macOS apps that could be tweaked at runtime                            |\n| [Rust](./experimental/forthic-rs)     | A Forthic tokenizer in Rust                                                                |\n| [zig](./experimental/forthic-zig)     | WIP Forthic implmentation using zig                                                        |\n\n### Pre-forthic Implementations\n\nPrior to Forthic, there were several experiments at building FORTH-like interpreters in a variety of languages\n| Host Language | Comments |\n| ------------- | -------- |\n| [asm](./experimental/pre-forthic/forrth-asm/) | Proof of concept in assembly language |\n| [C#](./experimental/pre-forthic/forrth-cs/) | Proof of concept in C# |\n| [Erlang](./experimental/pre-forthic/forrth-erl/) | Proof of concept in Erlang, which was one of the easiest Forth-like implementations |\n| [Fortran](./experimental/pre-forthic/forrth-f90/) | Proof of concept in Fortran, which was the hardest Forth-like implementation |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinkedin%2Fforthic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinkedin%2Fforthic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinkedin%2Fforthic/lists"}