{"id":30314050,"url":"https://github.com/clarify/aquagraph_clarify","last_synced_at":"2025-08-17T18:56:30.540Z","repository":{"id":43098818,"uuid":"465927607","full_name":"clarify/aquagraph_clarify","owner":"clarify","description":"Aquagraph visualization in arrows","archived":false,"fork":false,"pushed_at":"2022-03-18T10:59:42.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2023-04-05T14:24:52.275Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/clarify.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-03-04T00:21:36.000Z","updated_at":"2022-03-18T10:45:38.000Z","dependencies_parsed_at":"2022-09-07T19:50:56.463Z","dependency_job_id":null,"html_url":"https://github.com/clarify/aquagraph_clarify","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"purl":"pkg:github/clarify/aquagraph_clarify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clarify%2Faquagraph_clarify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clarify%2Faquagraph_clarify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clarify%2Faquagraph_clarify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clarify%2Faquagraph_clarify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/clarify","download_url":"https://codeload.github.com/clarify/aquagraph_clarify/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clarify%2Faquagraph_clarify/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270892212,"owners_count":24663543,"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-17T02:00:09.016Z","response_time":129,"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-17T18:56:09.730Z","updated_at":"2025-08-17T18:56:30.531Z","avatar_url":"https://github.com/clarify.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aquagraph\n\nAquagraph visualization in arrows, add user input and use fastapi to make opperations in a Neo4j database.\n\n# Dependencies\n\nTo connect with Neo4j and it's database, Neo4j must be installed locally:\n\n- Download Neo4j https://neo4j.com/download/\n\nSteps: Press Download. Add credentials. Click download desktop. Copy the activation key. Click and drag Neo4j Desktop to the Application folder. Open the Neo4j Desktop (go to Security \u0026 Privacy and click to open anyway). After you have open the Neo4j Desktop under the software registration paste the key that you have previously copied.\n\n- Create Project and Database\n\nClick to the Project icon (top left corner, looks file a folder). Create a new Project. Click the Add button and add _Local DBMS_. Name the database and create a password. Click create. Hover over the database and click **Start**. After it has been activated you will see a green circle next to the database name. Hover again over the database and click `Open Neo4j Browser`.\n\n**Save your password in the .env file.**\n\n- Python \u003e= v3.9 Interpreter.\n\n# Configure tools\n\nFirst cd to the directory where requirements.txt is located.\n\nCreate local env:\n\n    python3 -m venv venv\n    source venv/bin/activate\n\nInstall requirements\n\n    pip install --upgrade pip\n    pip install -r requirements.txt\n\nAdd your credentials from Clarify in the same directory. For more information click [here](https://docs.clarify.io/users/admin/integrations/credentials) and [here](https://colab.research.google.com/github/clarify/data-science-tutorials/blob/main/tutorials/Introduction.ipynb#credentials).\n\n## Aquagraph visualization in arrows\n\n1. Save the credentials `clarify-credentials.json` in the main folder\n2. Run the script `python process_items.py`\n\n- In the script you can define how many items to retrieve by changing the variable `n_items`, the number of created batches by changing the variable `n_batches` and the number of (random) initial connections between batch and items via the variable `connect_one_in_each`.\n\n3. Copy the content of the output file `result.json` to arrows.app by importing it.\n\n## How to run the API\n\n1. Make sure the Neo4j database is activated.\n2. cd to aquagraph_clarify\n3. run\n\n\u003e uvicorn main:app --port 8080 --reload\n\n4. Go to http://localhost:8080/docs\n5. In the Neo4j Desktop run `match(n) return n`\n\nFor now your database is empty. To add data, go to the arrows app and `export` the data as `Cypher` (click on the Create button and `Copy to clipboard`). Paste the content to a cell in Neo4j Browser and run it. Run `match(n) return n` to see your graph.\n\n# Note\n\nFeel free to make your own changes in the graph, export data and matadata from Clarify using our [Python SDK package](https://pypi.org/project/pyclarify/). You can also add or change post calls in the API, create querys and make opperations on the database.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclarify%2Faquagraph_clarify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclarify%2Faquagraph_clarify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclarify%2Faquagraph_clarify/lists"}