{"id":13533819,"url":"https://github.com/thepeergroup/aspen","last_synced_at":"2026-05-20T15:18:06.505Z","repository":{"id":45997395,"uuid":"244499006","full_name":"thepeergroup/aspen","owner":"thepeergroup","description":"Aspen is a markup language for turning text into graph data (via Cypher for Neo4j).","archived":false,"fork":false,"pushed_at":"2023-05-17T13:54:33.000Z","size":1516,"stargazers_count":64,"open_issues_count":15,"forks_count":7,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-10-07T12:32:59.701Z","etag":null,"topics":["cypher","graph-databases","graphs4good","neo4j"],"latest_commit_sha":null,"homepage":"https://aspen-lang.org","language":"Ruby","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/thepeergroup.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":["beechnut"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2020-03-02T23:39:07.000Z","updated_at":"2025-07-20T15:53:18.000Z","dependencies_parsed_at":"2022-08-25T09:20:59.972Z","dependency_job_id":"45316510-8825-4204-9633-ecb15c1668e2","html_url":"https://github.com/thepeergroup/aspen","commit_stats":null,"previous_names":["beechnut/aspen"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/thepeergroup/aspen","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thepeergroup%2Faspen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thepeergroup%2Faspen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thepeergroup%2Faspen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thepeergroup%2Faspen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thepeergroup","download_url":"https://codeload.github.com/thepeergroup/aspen/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thepeergroup%2Faspen/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279006349,"owners_count":26084084,"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-10-11T02:00:06.511Z","response_time":55,"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":["cypher","graph-databases","graphs4good","neo4j"],"created_at":"2024-08-01T07:01:23.403Z","updated_at":"2025-10-12T04:32:38.689Z","avatar_url":"https://github.com/thepeergroup.png","language":"Ruby","funding_links":["https://github.com/sponsors/beechnut"],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"readme":"# Aspen\n\nAspen is a simple markup language that transforms simple narrative information into rich graph data for use in Neo4j.\n\nTo put it another way, Aspen transforms narrative text to Cypher, specifically for use in creating graph data.\n\nIn short, Aspen transforms this:\n\n```aspen\n(Liz) [knows] (Jack)\n```\n\ninto (roughly) this\n\n```cypher\nMERGE (:Entity { name: \"Liz\" })-[:KNOWS]-\u003e(:Entity { name: \"Jack\" })\n```\n\nand can push it to a Neo4j database.\n\nWant Liz and Jack to be nodes with a `:Person` label? Just add a little config.\n\n```aspen\ndefault:\n  label: Person\n----\n(Liz) [knows] (Jack)\n```\n\n```aspen\nMERGE (:Person { name: \"Liz\" })-[:KNOWS]-\u003e(:Person { name: \"Jack\" })\n```\n\n\n### Installation\n\n```\n$ gem install aspen-cli\n```\n\nStart a new project:\n\n```\n$ aspen new your_project_name_here\n```\n\n### Documentation\n\n[Quickstart Guide](https://github.com/thepeergroup/aspen/wiki/Quickstart-Guide)\n\n[Full documentation in the Wiki](https://github.com/thepeergroup/aspen/wiki)\n\n\n### Why use Aspen?\n\nYou need to turn notes and narratives into a network diagram or graph data.\n\nYou may also want to connect that data to other data, maybe graph data, maybe tabular data.\n\nFor what you want:\n\n- Spreadsheets are too rigid,\n- Machine learning and Natural Language Processing (NLP) are out of reach, and\n- You're ok using command-line tools for now (we hope to offer a GUI soon)\n\n\n## Code of Conduct\n\nWe expect that anyone working on this project will be good and kind to each other. We're developing software about relationships, and anyone who works on this project is expected to have healthy relating skills.\n\nEveryone interacting in the Aspen project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/beechnut/aspen/blob/master/CODE_OF_CONDUCT.md).\n\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/beechnut/aspen. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/beechnut/aspen/blob/master/CODE_OF_CONDUCT.md).\n\nIf you'd like to see Aspen grow, please [get in touch](https://github.com/thepeergroup/aspen/discussions), whether you're a developer, user, or potential sponsor. We have ideas on ways to grow Aspen, and we need your help to do so, whatever form that help takes.\n\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthepeergroup%2Faspen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthepeergroup%2Faspen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthepeergroup%2Faspen/lists"}