{"id":15346275,"url":"https://github.com/joshinnis/age","last_synced_at":"2025-03-11T08:46:35.790Z","repository":{"id":65311187,"uuid":"589466373","full_name":"JoshInnis/age","owner":"JoshInnis","description":null,"archived":false,"fork":false,"pushed_at":"2023-01-16T07:28:14.000Z","size":6868,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-17T23:31:04.773Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JoshInnis.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}},"created_at":"2023-01-16T07:26:24.000Z","updated_at":"2023-01-16T07:28:33.000Z","dependencies_parsed_at":"2023-01-16T12:30:47.196Z","dependency_job_id":null,"html_url":"https://github.com/JoshInnis/age","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoshInnis%2Fage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoshInnis%2Fage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoshInnis%2Fage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoshInnis%2Fage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JoshInnis","download_url":"https://codeload.github.com/JoshInnis/age/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243004103,"owners_count":20220236,"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":[],"created_at":"2024-10-01T11:20:38.395Z","updated_at":"2025-03-11T08:46:35.755Z","avatar_url":"https://github.com/JoshInnis.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n     \u003cimg src=\"https://age.apache.org/age-manual/master/_static/logo.png\" width=\"30%\" height=\"30%\"\u003e\n\u003c/p\u003e\n\u003cbr\u003e\n\n\u003ch3 align=\"center\"\u003e\n    \u003ca href=\"https://age.apache.org/age-manual/master/_static/logo.png\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://age.apache.org/age-manual/master/_static/logo.png\"\" height=\"25\" height=\"30% alt=\"Apache AGE\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://age.apache.org/age-manual/master/_static/logo.png\" target=\"_blank\"\u003e\n    \u003c/a\u003e\n     is a leading multi-model graph database \u003c/h3\u003e\n     \n\u003c/h3\u003e\n\n\u003ch3 align=\"center\"\u003eGraph Processing \u0026 Analytics for Relational Databases\u003c/h3\u003e\n\n\u003cbr\u003e\n\n\n\u003c/br\u003e\n\n\n\n\u003cp align=\"center\"\u003e                                                                                                    \n  \u003ca href=\"https://github.com/apache/age/blob/master/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/apache/age\"/\u003e\n  \u003c/a\u003e\n  \u0026nbsp;\n  \u003ca href=\"https://github.com/apache/age/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Release-v1.2.0-FFA500?labelColor=gray\u0026style=flat\u0026link=https://github.com/apache/age/releases\"/\u003e\n  \u003c/a\u003e\n  \u0026nbsp;\n  \u003ca href=\"https://github.com/apache/age/issues\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues/apache/age\"/\u003e\n  \u003c/a\u003e\n  \u0026nbsp;\n  \u003ca href=\"https://github.com/apache/age/network/members\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/forks/apache/age\"/\u003e\n  \u003c/a\u003e\n  \u0026nbsp;\n  \u003ca href=\"https://github.com/apache/age/stargazers\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/apache/age\"/\u003e\n  \u003c/a\u003e\n  \u0026nbsp;\n  \u003ca href=\"https://discord.gg/NMsBs9X8Ss\"\u003e\n    \u003cimg src=\"https://img.shields.io/discord/1022177873127280680.svg?label=discord\u0026style=flat\u0026color=5a66f6\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\n\n\u003ch2\u003e\u003cimg height=\"30\" src=\"/img/AGE.png\"\u003e\u0026nbsp;\u0026nbsp;What is Apache AGE?\u003c/h2\u003e\n\n[Apache AGE](https://age.apache.org/#) is an extension for PostgreSQL that enables users to leverage a graph database on top of the existing relational databases. AGE is an acronym for A Graph Extension and is inspired by Bitnine's AgensGraph, a multi-model database fork of PostgreSQL. The basic principle of the project is to create a single storage that handles both the relational and graph data model so that the users can use the standard ANSI SQL along with openCypher, one of the most popular graph query languages today. \n\u003c/br\u003e\n\u003c/br\u003e\n\u003c/br\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"/img/age-01.png\" width=\"80%\" height=\"80%\"\u003e\n\u003c/p\u003e\n\n\u003c/br\u003e\n\nSince AGE is based on the powerful PostgreSQL RDBMS, it is robust and fully featured. AGE is optimized for handling complex connected graph data. It provides plenty of robust databases features essential to the database environment, including ACID transactions, multi-version concurrency control (MVCC), stored procedure, triggers, constraints, sophisticated monitoring, and a flexible data model (JSON). Users with a relational background who require graph data analytics can use this extension with minimal effort because they can use existing data without having to go through migration. \n\nThere is a strong need for cohesive, easy-to-implement multi-model databases. As an extension of PostgreSQL, AGE supports all the functionalities and features of PostgreSQL while also offering a graph model to boot.\n\n\n\u003ch2\u003e\u003cimg height=\"30\" src=\"/img/tick.svg\"\u003e\u0026nbsp;\u0026nbsp;Overview\u003c/h2\u003e\n\nApache AGE is : \n\n- **Powerful**: adds graph database support to the already popular PostgreSQL database: PostgreSQL is used by organizations including Apple, Spotify, and NASA.\n- **Flexible**: allows you to perform openCypher queries, which makes complex queries much easier to write. It also enables multiple graphs at the same time.\n- **Intelligent**: allows you to perform graph queries that are the basis for many next-level web services such as fraud detection, master data management, product recommendations, identity and relationship management, experience personalization, knowledge management, and more.\n\n\u003ch2\u003e\u003cimg height=\"30\" src=\"/img/features.svg\"\u003e\u0026nbsp;\u0026nbsp;Features\u003c/h2\u003e\n\u003c/br\u003e\n\u003c/br\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"/img/age-03.png\" width=\"80%\" height=\"80%\"\u003e\n\u003c/p\u003e\n\u003c/br\u003e\n\n- **Cypher Query**: supports graph query language\n- **Hybrid Querying**: enables SQL and/or Cypher\n- **Querying**: enables multiple graphs\n- **Hierarchical**: graph label organization\n- **Property Indexes**: on both vertices(nodes) and edges\n- **Full PostgreSQL**: supports PG features\n\n\n\n\u003ch2\u003e\u003cimg height=\"30\" src=\"/img/documentation.svg\"\u003e\u0026nbsp;\u0026nbsp;Documentation\u003c/h2\u003e\n\nRefer to our latest [Apache AGE documentation](https://age.apache.org/age-manual/master/index.html) to learn about installation, features, built-in functions, and  Cypher queries.\n\n\n\n\u003ch2\u003e\u003cimg height=\"30\" src=\"/img/installation.svg\"\u003e\u0026nbsp;\u0026nbsp;Pre-Installation\u003c/h2\u003e\n\nInstall the following essential libraries according to each OS. Building AGE from the source depends on the following Linux libraries (Ubuntu package names shown below):\n\n- **CentOS**\n```bash\nyum install gcc glibc glib-common readline readline-devel zlib zlib-devel flex bison\n```\n- **Fedora**\n```bash\ndnf install gcc glibc bison flex readline readline-devel zlib zlib-devel\n```\n- **Ubuntu**\n```bash\nsudo apt-get install build-essential libreadline-dev zlib1g-dev flex bison\n```\n\n\u003ch2\u003e\u003cimg height=\"30\" src=\"/img/installation.svg\"\u003e\u0026nbsp;\u0026nbsp;Installation\u003c/h2\u003e\n\nApache AGE is intended to be simple to install and run. It can be installed with Docker and other traditional ways. \n\n\u003ch4\u003e\u003ca\u003e\u003cimg width=\"20\" src=\"/img/pg.svg\"\u003e\u003c/a\u003e\n\u0026nbsp;Install PosgtreSQL\n\u003c/h4\u003e\n\nYou will need to install an AGE compatible version of Postgres\u003ca\u003e, for now AGE supports Postgres 11 and 12. Supporting the latest versions is on AGE roadmap. \n     \n\u003ch4\u003e\n\u0026nbsp;Install From Package Manager\n\u003c/h4\u003e\n\nYou can use a \u003ca href=\"https://www.postgresql.org/download/\"\u003epackage management \u003c/a\u003e that your OS provides to download AGE.\n\n\u003cbr\u003e\n\n```bash\nsudo apt install postgresql \n\n```\n\u003ch4\u003e\n\u0026nbsp;Install From Source Code\n\u003c/h4\u003e\n\nYou can \u003ca href=\"https://www.postgresql.org/ftp/source/\"\u003e download the Postgres \u003c/a\u003e source code and install your own instance of Postgres. You can read instructions on how to install from source code for different versions on the \u003ca href=\"https://www.postgresql.org/docs/11/installation.html\"\u003eofficial Postgres Website.\u003c/a\u003e\n\n\n\n\u003ch4\u003e\u003cimg width=\"20\" src=\"/img/tux.svg\"\u003e\u003cimg width=\"20\" src=\"/img/apple.svg\"\u003e \u0026nbsp;Install AGE on Linux and MacOS\n\u003c/h4\u003e\n\nClone the \u003ca href=\"https://github.com/apache/age\"\u003egithub repository\u003c/a\u003e or download the\u003ca href=\"https://github.com/apache/age/releases\"\u003edownload an official release.\n\u003c/a\u003e\nRun the pg_config utility and check the version of PostgreSQL. Currently, only PostgreSQL versions 11 \u0026 12 are supported. If you have any other version of Postgres, you will need to install PostgreSQL version 11 \u0026 12.\n\u003cbr\u003e\n    \n```bash\npg_config\n```\nRun the following command in the source code directory of Apache AGE to build and install the extension.  \n     \n```bash\nmake install\n```\n     \nIf the path to your Postgres installation is not in the PATH variable, add the path in the arguments:\n```bash\nmake PG_CONFIG=/path/to/postgres/bin/pg_config install\n```\n\n\n\u003ch4\u003e\u003c/a\u003e\u003cimg width=\"30\" src=\"/img/docker.svg\"\u003e\u003c/a\u003e\n\u0026nbsp;Run using Docker\n\u003c/h4\u003e\n\n\u003ch5\u003e Get the docker image \u003c/h5\u003e\n\n```bash\ndocker pull apache/age\n\n```\n\u003ch5\u003e Create AGE docker container \u003c/h5\u003e\n\n```bash\ndocker run \\\n    --name age  \\\n    -p 5455:5432 \\\n    -e POSTGRES_USER=postgresUser \\\n    -e POSTGRES_PASSWORD=postgresPW \\\n    -e POSTGRES_DB=postgresDB \\\n    -d \\\n    apache/age\n```\n\n\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"/img/contents.svg\"\u003e\u0026nbsp;\u0026nbsp;Post Installation\u003c/h2\u003e\n\nFor every connection of AGE you start, you will need to load the AGE extension.\n\n```bash\nCREATE EXTENSION age;\n```\n```bash\nLOAD 'age';\n```\n```bash\nSET search_path = ag_catalog, \"$user\", public;\n```\n\n\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"/img/contents.svg\"\u003e\u0026nbsp;\u0026nbsp;Quick Start\u003c/h2\u003e\n\nTo create a graph, use the create_graph function located in the ag_catalog namespace.\n\n```bash\nSELECT create_graph('graph_name');\n```\n\nTo create a single vertex, use the CREATE clause. \n\n```bash\nSELECT * \nFROM cypher('graph_name', $$\n    CREATE (n)\n$$) as (v agtype);\n```\n\n\nTo create a single vertex with the label, use the CREATE clause. \n\n```bash\nSELECT * \nFROM cypher('graph_name', $$\n    CREATE (:label)\n$$) as (v agtype);\n```\n\nTo query the graph, you can use the MATCH clause.  \n\n```bash\nSELECT * FROM cypher('graph_name', $$\nMATCH (v)\nRETURN v\n$$) as (v agtype);\n```\n\nYou can use the following to create an edge, for example, between two nodes. \n\n```bash\nSELECT * \nFROM cypher('graph_name', $$\n    MATCH (a:label), (b:label)\n    WHERE a.property = 'Node A' AND b.property = 'Node B'\n    CREATE (a)-[e:RELTYPE]-\u003e(b)\n    RETURN e\n$$) as (e agtype);\n```\n\n\nTo create an edge and set properties.\n\n```bash\nSELECT * \nFROM cypher('graph_name', $$\n    MATCH (a:label), (b:label)\n    WHERE a.property = 'Node A' AND b.property = 'Node B'\n    CREATE (a)-[e:RELTYPE {property:a.property + '\u003c-\u003e' + b.property}]-\u003e(b)\n    RETURN e\n$$) as (e agtype);\n```\n\nExample \n\n```bash\nSELECT * \nFROM cypher('graph_name', $$\n    MATCH (a:Person), (b:Person)\n    WHERE a.name = 'Node A' AND b.name = 'Node B'\n    CREATE (a)-[e:RELTYPE {name:a.name + '\u003c-\u003e' + b.name}]-\u003e(b)\n    RETURN e\n$$) as (e agtype);\n```\n\n\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"/img/gettingstarted.svg\"\u003e\u0026nbsp;\u0026nbsp;Language Specific Drivers\u003c/h2\u003e\n\nStarting with Apache AGE is very simple. You can easily select your platform and incorporate the relevant SDK into your code.\n\u003c/br\u003e\n\u003c/br\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"/img/age-02.png\" width=\"80%\" height=\"80%\"\u003e\n\u003c/p\u003e\n\n\n\u003ch4\u003eBuilt-in\u003c/h4\u003e\n\n- [Go driver](./drivers/golang)\n- [Java driver](./drivers/jdbc)\n- [NodeJs driver](./drivers/nodejs)\n- [Python driver](./drivers/python)\n\n\u003ch4\u003eCommunity-driven Driver\u003c/h4\u003e\n\n- [Apache AGE Rust Driver](https://github.com/Dzordzu/rust-apache-age.git)\n\n\n\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"/img/contributing.svg\"\u003e\u0026nbsp;\u0026nbsp;Community\u003c/h2\u003e\n\nJoin the AGE community for help, questions, discussions, and contributions. \n\n- Check our [website](https://age.apache.org/)\n- Chat live with us on [Discord](https://discord.com/invite/NMsBs9X8Ss/)\n- Follow us on [Twitter](https://twitter.com/apache_age?s=20\u0026t=7Hu8Txk4vjvuEp-ryakacg)\n- Join our [Dev community](https://lists.apache.org/list.html?dev@age.apache.org)\n\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"/img/visualization.svg\"\u003e\u0026nbsp;\u0026nbsp;Graph Visualization Tool for AGE\u003c/h2\u003e\n\n\nApache AGE Viewer is a user interface for Apache AGE that provides visualization and exploration of data.\nThis web visualization tool allows users to enter complex graph queries and explore the results in graph and table forms.\nApache AGE Viewer is enhanced to proceed with extensive graph data and discover insights through various graph algorithms.\nApache AGE Viewer will become a graph data administration and development platform for Apache AGE to support multiple relational databases: \u003chttps://github.com/apache/age-viewer\u003e.\n\n**This is a visualization tool.**\nAfter installing AGE Extension, you may use this tool to get access to the visualization features.\n\n\n![Viewer gdb, and graph](/img/agce.gif)\n\n\n\n\u003ch2\u003e\u003cimg height=\"20\" src=\"/img/community.svg\"\u003e\u0026nbsp;\u0026nbsp;Contributing\u003c/h2\u003e\n\nYou can improve ongoing efforts or initiate new ones by sending pull requests to [this repository](https://github.com/apache/age).\nAlso, you can learn from the code review process, how to merge pull requests, and from code style compliance to documentation by visiting the [Apache AGE official site - Developer Guidelines](https://age.apache.org/contribution/guide).\nSend all your comments and inquiries to the user mailing list, users@age.apache.org.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoshinnis%2Fage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoshinnis%2Fage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoshinnis%2Fage/lists"}