# kgn
[](https://pypi.org/project/kgn/)
[](https://github.com/mark-watson/kgn/releases)
[](https://github.com/mark-watson/kgn/actions?query=workflow%3ATest)
[](https://github.com/mark-watson/kgn/blob/master/LICENSE)
# Interactive exploration of Knowledge Graphs using natural language
This is a tool that interactively explores the DBPedia Knowledge Graph. The user inputs a list of people, companies, places, etc. and entities in DBPedia are identified using SPARQL queries and a spaCy language deep learning language model and relations are also found between these entities. A local SQlite3 database is used to cache SPARQL query results.
This code is an example program in my book "Practical Python Artificial Intelligence Programming" [https://leanpub.com/pythonai](https://leanpub.com/pythonai). You can read this book and all of my recent eBooks at my website [https://markwatson.com](https://markwatson.com).
This code is derived from a Common Lisp example in my book "Loving Common Lisp, or the Savvy Programmer's Secret Weapon" [https://leanpub.com/lovinglisp](https://leanpub.com/lovinglisp) and in my Hy (hylang) book "A Lisp Programmer Living in Python-Land: The Hy Programming Language" [https://leanpub.com/hy-lisp-python](https://leanpub.com/hy-lisp-python).
## Installation
Install this tool using `pip`:
pip install kgn
## Usage
For help, run:
kgn --help
You can also use:
python -m kgn --help
## Example output
Most output is removed fro brevity:
```
$ python kgn.py
table dbpedia already exists
Knowledge Graph Navigator (note: only runs in a terminal)
Enter a list of entities: Bill Gates, Steve Jobs, IBM, Apple, Microsoft, Seattle
Generated SPARQL to get DBPedia entity URIs from a name:
select distinct ?s ?comment { ?s ?p "Bill Gates"@en . ?s <http://www . w3 . org/2000/01/rdf-schema#comment> ?comment . FILTER (lang(?comment) = 'en') . ?s <http://www . w3 . org/1999/02/22-rdf-syntax-ns#type> <http://dbpedia . org/ontology/Person> . } limit 15
Using cached query results
Generated SPARQL to get DBPedia entity URIs from a name:
select distinct ?s ?comment { ?s ?p "Steve Jobs"@en . ?s <http://www . w3 . org/2000/01/rdf-schema#comment> ?comment . FILTER (lang(?comment) = 'en') . ?s <http://www . w3 . org/1999/02/22-rdf-syntax-ns#type> <http://dbpedia . org/ontology/Person> . } limit 15
Using cached query results
...
People
Hit enter or return key when done:
1) Bill Gates || Harry Roy Lewis (born 1947) is an American computer scientist, mathem...
2) Bill Gates || Cascade Investment, L.L.C. is an American holding company and private ...
3) Bill Gates || Simon Wood is a British cook and winner of the 2015 edition of MasterC...
4) Bill Gates || Jerry P. Dyer (born May 3, 1959) is an American politician and former ...
5) Bill Gates || William Henry Gates III (born October 28, 1955) is an American busines...
6) Steve Jobs || Steven Paul Jobs (February 24, 1955 – October 5, 2011) was an American...
[1/2/3/4/5/6]? :
Selected 'Bill Gates || William Henry Gates III (born October 28, 1955) is an American busines...'. Hit return key or enter to stop.
Selected 'Steve Jobs || Steven Paul Jobs (February 24, 1955 – October 5, 2011) was an American...'. Hit return key or enter to stop.
Places
Hit enter or return key when done:
1) Seattle || Washington (/ˈwɒʃɪŋtən/), officially the State of Washington, is a sta...
2) Seattle || Medina (/məˈdaɪnə/) is a mostly residential city in Eastside, King Cou...
3) Seattle || Northeast 130th Street Beach is a 60-foot-wide (18 m) public beach in ...
4) Seattle || Seattle (/siˈætəl/ see-AT-əl) is a seaport city on the West Coast of t...
5) Seattle || The Troy Laundry Building is a 1927 building in the South Lake Union/C...
6) Seattle || Louisa Boren Park is a 7.2-acre (29,000 m2) park in Seattle, Washingto...
7) Seattle || Bitter Lake is a neighborhood in Seattle, Washington, United States, n...
8) Seattle || King County is located in the U.S. state of Washington. The population...
9) Seattle || Formerly known as Diocese of Nesqually, 1850-1907. The Roman Catholic ...
[1/2/3/4/5/6/7/8/9]? :
Selected 'Seattle || Washington (/ˈwɒʃɪŋtən/), officially the State of Washington, is a sta...'. Hit return key or enter to stop.
Organizations
...
Entity data:
{'entities': ['Bill Gates || William Henry Gates III (born October 28, 1955) '
'is an American busines...',
'Steve Jobs || Steven Paul Jobs (February 24, 1955 – October 5, '
'2011) was an American...',
'Seattle || Washington (/ˈwɒʃɪŋtən/), officially the State of '
'Washington, is a sta...',
'IBM || International Business Machines Corporation (IBM) is an '
'American multi...',
'IBM || Sequent Computer Systems was a computer company that '
'designed and manu...',
'IBM || Applix Inc. was a computer software company founded in '
'1983 based in W...']}
Generated SPARQL to get relationships between two entities:
SELECT DISTINCT ?p { <http://dbpedia . org/resource/Bill_Gates> ?p <http://dbpedia . org/resource/Steve_Jobs> . FILTER (!regex(str(?p), 'wikiPage', 'i')) } LIMIT 5
...
Generated SPARQL to get relationships between two entities:
SELECT DISTINCT ?p { <http://dbpedia . org/resource/Bill_Gates> ?p <http://dbpedia . org/resource/Steve_Jobs> . FILTER (!regex(str(?p), 'wikiPage', 'i')) } LIMIT 5
...
Discovered relationship links:
<http://dbpedia.org/resource/IBM> --> http://dbpedia.org/ontology/owner --> <http://dbpedia.org/resource/Applix>
<http://dbpedia.org/resource/IBM> --> http://dbpedia.org/ontology/owningCompany --> <http://dbpedia.org/resource/Applix>
<http://dbpedia.org/resource/Applix> --> http://dbpedia.org/ontology/owner --> <http://dbpedia.org/resource/IBM>
<http://dbpedia.org/resource/Applix> --> http://dbpedia.org/ontology/owningCompany --> <http://dbpedia.org/resource/IBM>
Enter a list of entities:
```
## Possible problems
I cache SPARQL queries to DBPedia in a local SQlite3 database. I sometimes need to delete the database file.
## Development
To contribute to this tool, first checkout the code. Then create a new virtual environment:
cd kgn
python -m venv venv
source venv/bin/activate
Now install the dependencies and test dependencies:
pip install -e '.[test]'
To run the tests:
pytest
Raw data
{
"_id": null,
"home_page": "https://github.com/mark-watson/kgn",
"name": "kgn",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "Mark Watson",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/6f/72/0875c25cbb15b1a453e2c75660b5e016b800c63dd02a640217aeffe85368/kgn-0.46.tar.gz",
"platform": null,
"description": "# kgn\n\n[](https://pypi.org/project/kgn/)\n[](https://github.com/mark-watson/kgn/releases)\n[](https://github.com/mark-watson/kgn/actions?query=workflow%3ATest)\n[](https://github.com/mark-watson/kgn/blob/master/LICENSE)\n\n# Interactive exploration of Knowledge Graphs using natural language\n\nThis is a tool that interactively explores the DBPedia Knowledge Graph. The user inputs a list of people, companies, places, etc. and entities in DBPedia are identified using SPARQL queries and a spaCy language deep learning language model and relations are also found between these entities. A local SQlite3 database is used to cache SPARQL query results.\n\nThis code is an example program in my book \"Practical Python Artificial Intelligence Programming\" [https://leanpub.com/pythonai](https://leanpub.com/pythonai). You can read this book and all of my recent eBooks at my website [https://markwatson.com](https://markwatson.com).\n\nThis code is derived from a Common Lisp example in my book \"Loving Common Lisp, or the Savvy Programmer's Secret Weapon\" [https://leanpub.com/lovinglisp](https://leanpub.com/lovinglisp) and in my Hy (hylang) book \"A Lisp Programmer Living in Python-Land: The Hy Programming Language\" [https://leanpub.com/hy-lisp-python](https://leanpub.com/hy-lisp-python).\n\n\n## Installation\n\nInstall this tool using `pip`:\n\n pip install kgn\n\n## Usage\n\nFor help, run:\n\n kgn --help\n\nYou can also use:\n\n python -m kgn --help\n\n## Example output\n\nMost output is removed fro brevity:\n\n```\n$ python kgn.py \ntable dbpedia already exists\nKnowledge Graph Navigator (note: only runs in a terminal)\nEnter a list of entities: Bill Gates, Steve Jobs, IBM, Apple, Microsoft, Seattle\nGenerated SPARQL to get DBPedia entity URIs from a name:\nselect distinct ?s ?comment { ?s ?p \"Bill Gates\"@en . ?s <http://www . w3 . org/2000/01/rdf-schema#comment> ?comment . FILTER (lang(?comment) = 'en') . ?s <http://www . w3 . org/1999/02/22-rdf-syntax-ns#type> <http://dbpedia . org/ontology/Person> . } limit 15 \nUsing cached query results\nGenerated SPARQL to get DBPedia entity URIs from a name:\nselect distinct ?s ?comment { ?s ?p \"Steve Jobs\"@en . ?s <http://www . w3 . org/2000/01/rdf-schema#comment> ?comment . FILTER (lang(?comment) = 'en') . ?s <http://www . w3 . org/1999/02/22-rdf-syntax-ns#type> <http://dbpedia . org/ontology/Person> . } limit 15 \nUsing cached query results\n\n...\n\nPeople\nHit enter or return key when done:\n 1) Bill Gates || Harry Roy Lewis (born 1947) is an American computer scientist, mathe\u00adm...\n 2) Bill Gates || Cascade Investment, L.L.C. is an American holding company and private ...\n 3) Bill Gates || Simon Wood is a British cook and winner of the 2015 edition of MasterC...\n 4) Bill Gates || Jerry P. Dyer (born May 3, 1959) is an American politician and former ...\n 5) Bill Gates || William Henry Gates III (born October 28, 1955) is an American busines...\n 6) Steve Jobs || Steven Paul Jobs (February 24, 1955 \u2013 October 5, 2011) was an American...\n[1/2/3/4/5/6]? :\nSelected 'Bill Gates || William Henry Gates III (born October 28, 1955) is an American busines...'. Hit return key or enter to stop.\nSelected 'Steve Jobs || Steven Paul Jobs (February 24, 1955 \u2013 October 5, 2011) was an American...'. Hit return key or enter to stop.\nPlaces\nHit enter or return key when done:\n 1) Seattle || Washington (/\u02c8w\u0252\u0283\u026a\u014bt\u0259n/), officially the State of Washington, is a sta...\n 2) Seattle || Medina (/m\u0259\u02c8da\u026an\u0259/) is a mostly residential city in Eastside, King Cou...\n 3) Seattle || Northeast 130th Street Beach is a 60-foot-wide (18 m) public beach in ...\n 4) Seattle || Seattle (/si\u02c8\u00e6t\u0259l/ see-AT-\u0259l) is a seaport city on the West Coast of t...\n 5) Seattle || The Troy Laundry Building is a 1927 building in the South Lake Union/C...\n 6) Seattle || Louisa Boren Park is a 7.2-acre (29,000 m2) park in Seattle, Washingto...\n 7) Seattle || Bitter Lake is a neighborhood in Seattle, Washington, United States, n...\n 8) Seattle || King County is located in the U.S. state of Washington. The population...\n 9) Seattle || Formerly known as Diocese of Nesqually, 1850-1907. The Roman Catholic ...\n[1/2/3/4/5/6/7/8/9]? :\nSelected 'Seattle || Washington (/\u02c8w\u0252\u0283\u026a\u014bt\u0259n/), officially the State of Washington, is a sta...'. Hit return key or enter to stop.\nOrganizations\n\n...\n\nEntity data:\n{'entities': ['Bill Gates || William Henry Gates III (born October 28, 1955) '\n 'is an American busines...',\n 'Steve Jobs || Steven Paul Jobs (February 24, 1955 \u2013 October 5, '\n '2011) was an American...',\n 'Seattle || Washington (/\u02c8w\u0252\u0283\u026a\u014bt\u0259n/), officially the State of '\n 'Washington, is a sta...',\n 'IBM || International Business Machines Corporation (IBM) is an '\n 'American multi...',\n 'IBM || Sequent Computer Systems was a computer company that '\n 'designed and manu...',\n 'IBM || Applix Inc. was a computer software company founded in '\n '1983 based in W...']}\n\nGenerated SPARQL to get relationships between two entities:\nSELECT DISTINCT ?p { <http://dbpedia . org/resource/Bill_Gates> ?p <http://dbpedia . org/resource/Steve_Jobs> . FILTER (!regex(str(?p), 'wikiPage', 'i')) } LIMIT 5 \n\n...\n\nGenerated SPARQL to get relationships between two entities:\nSELECT DISTINCT ?p { <http://dbpedia . org/resource/Bill_Gates> ?p <http://dbpedia . org/resource/Steve_Jobs> . FILTER (!regex(str(?p), 'wikiPage', 'i')) } LIMIT 5 \n\n...\n\nDiscovered relationship links:\n\n<http://dbpedia.org/resource/IBM> --> http://dbpedia.org/ontology/owner --> <http://dbpedia.org/resource/Applix>\n<http://dbpedia.org/resource/IBM> --> http://dbpedia.org/ontology/owningCompany --> <http://dbpedia.org/resource/Applix>\n<http://dbpedia.org/resource/Applix> --> http://dbpedia.org/ontology/owner --> <http://dbpedia.org/resource/IBM>\n<http://dbpedia.org/resource/Applix> --> http://dbpedia.org/ontology/owningCompany --> <http://dbpedia.org/resource/IBM>\nEnter a list of entities: \n\n```\n\n## Possible problems\n\nI cache SPARQL queries to DBPedia in a local SQlite3 database. I sometimes need to delete the database file.\n\n\n## Development\n\nTo contribute to this tool, first checkout the code. Then create a new virtual environment:\n\n cd kgn\n python -m venv venv\n source venv/bin/activate\n\nNow install the dependencies and test dependencies:\n\n pip install -e '.[test]'\n\nTo run the tests:\n\n pytest\n",
"bugtrack_url": null,
"license": "Apache License, Version 2.0",
"summary": "Interactive exploration of Knowledge Graphs using natural language",
"version": "0.46",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "0fd7a26f9ed20349c96c7955239bc52f",
"sha256": "68ae5979d2913dfba37722860d9158140dd89e4d14e0da0386e597d6c9a7bd14"
},
"downloads": -1,
"filename": "kgn-0.46.tar.gz",
"has_sig": false,
"md5_digest": "0fd7a26f9ed20349c96c7955239bc52f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 13485,
"upload_time": "2022-12-01T19:56:57",
"upload_time_iso_8601": "2022-12-01T19:56:57.366815Z",
"url": "https://files.pythonhosted.org/packages/6f/72/0875c25cbb15b1a453e2c75660b5e016b800c63dd02a640217aeffe85368/kgn-0.46.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-01 19:56:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "mark-watson",
"github_project": "kgn",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "click",
"specs": [
[
"~=",
"8.0.4"
]
]
},
{
"name": "spacy",
"specs": [
[
"~=",
"3.3.1"
]
]
},
{
"name": "requests",
"specs": [
[
"~=",
"2.28.1"
]
]
},
{
"name": "readchar",
"specs": [
[
"~=",
"4.0.3"
]
]
},
{
"name": "setuptools",
"specs": [
[
"~=",
"65.5.0"
]
]
}
],
"lcname": "kgn"
}
JSON
