Skip to content

Add entity / Relation extraction component #85

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Conversation

stellasia
Copy link
Contributor

@stellasia stellasia commented Jul 31, 2024

Description

This PR adds the Entity & Relation extraction base component and implementation using LLM, using a pretty simple prompt that can be configured (similarly to what is done for RAG)

Type of Change

  • New feature
  • Bug fix
  • Breaking change
  • Documentation update
  • Project configuration change

Complexity

Note

Please provide an estimated complexity of this PR of either Low, Medium or High

Complexity: Medium

How Has This Been Tested?

  • Unit tests
  • E2E tests
  • Manual tests

Checklist

The following requirements should have been met (depending on the changes in the branch):

  • Documentation has been updated
  • Unit tests have been updated
  • E2E tests have been updated
  • Examples have been updated
  • New files have copyright header
  • CLA (https://neo4j.com/developer/cla/) has been signed
  • CHANGELOG.md updated if appropriate

stellasia and others added 5 commits July 31, 2024 11:26
* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>
* Added text splitter adapter class

* Added copyright header to new files

* Added __future__ import to text_splitters.py for backwards compatibility of type hints

* Moved text splitter file and tests

* Split text splitter adapter into 2 adapters

* Added optional metadata to text chunks

* Fixed typos

* Moved text splitters inside of the components folder

* Fixed Component import
@willtai willtai force-pushed the feature/kg_builder branch from 4171f65 to 83b2f56 Compare July 31, 2024 15:17
@stellasia stellasia changed the title Entity / Relation extraction component Add entity / Relation extraction component Jul 31, 2024
@stellasia stellasia marked this pull request as ready for review August 1, 2024 13:52
…e__ annotations => back to the typing.Dict annotation which is compatible with all python versions
=> should raise an error if run is not implemented?
@stellasia stellasia requested a review from willtai August 6, 2024 09:31
)
result = {"nodes": [], "relationships": []}
try:
chunk_graph = Neo4jGraph(**result)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How do we connect the chunks to the extracted nodes using this approach? Do we not need to do it manually after the graph has been extracted? I'm also wondering if we might want to point the chunks to each other i.e. include a NEXT_CHUNK relationship which links them?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Entities have a "chunk_index" property, so that we can save them. But at the moment, chunks are not included as nodes in the graph. Do you think it should be done in this component? I'm not sure we're still in the scope of the entity and relation extraction.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think Oskar mentioned we also want to be able to create lexical graphs (if that's the right terminology) which include the chunks and embeddings. If we do it would make sense to connect them to the other chunks and associated nodes so the queries for retrievers like the VectorCypherRetriever are easy to write. We could include another component to connect the chunks to the rest of the graph but imo it also makes sense to do it here as we're already looping through the chunks so it wouldn't be that hard to create the NEXT_CHUNK relationship between the chunks. Then for each chunk we could create a chunk node and loop through the other nodes and create a relationship which joins them.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done in 0c46445

I think we'll see in the future if we need to have a separate component, could be useful for people who might want to first do the chunk extraction, save them, and then run ER extraction for instance, but we're not there yet.

Copy link
Contributor

@willtai willtai left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@stellasia stellasia merged commit b74501f into neo4j:feature/kg_builder Aug 8, 2024
8 checks passed
@stellasia stellasia deleted the feature/kg_builder_er_extractor branch August 8, 2024 11:19
alexthomas93 added a commit that referenced this pull request Aug 13, 2024
* Pipeline  (#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Pipeline  (#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Adds a Text Splitter (#82)

* Added text splitter adapter class

* Added copyright header to new files

* Added __future__ import to text_splitters.py for backwards compatibility of type hints

* Moved text splitter file and tests

* Split text splitter adapter into 2 adapters

* Added optional metadata to text chunks

* Fixed typos

* Moved text splitters inside of the components folder

* Fixed Component import

* Added a TextChunkEmbedder (#87)

* Added a TextChunkEmbedder

* Added the copyright header to test_embedder.py

* Updated test_text_chunk_embedder_run

* Adds a knowledge graph writer (#83)

* Added copyright header to new files

* Added copyright header to kg_writer.py

* Added __future__ import to kg_writer.py for backwards compatibility of type hints

* Added E2E test for Neo4jWriter

* Added a copyright header to test_kg_builder_e2e.py

* Added upsert_vector test for relationship embeddings

* Moved KG writer and its tests

* Moved Neo4jGraph and associated objects to a new file

* Renamed KG builder fixture

* Added unit tests for KG writer

* Split upsert_vector into 2 functions

* Fixed broken cypher query strings

* Removed embedding creation from Neo4jWriter

* Fixed setup_neo4j_for_kg_construction fixture

* Added KGWriterModel class

* Fixed minor mistake in test_weaviate_e2e.py

* Renamed kg_construction folder to components

* Updated unit tests with new folder structure

* Fixed broken import

* Fixed copyright headers

* Added missing docstrings

* Fixed typo

* Add documentation for pipeline exceptions (#90)

* Fixes and refactors the KG writer component (#92)

* Fixes and refactors the KG writer component

* Fixed mypy error

* Made start_node_id and end_node_id parameters in UPSERT_RELATIONSHIP_QUERY

* Add schema for kg builder (#88)

* Add schema for kg builder and tests

* Fixed mypy checks

* Reverted kg builder example with schema

* Revert to List and Dict due to Python3.8 issue with using get_type_hints

* Added properties to Entity and Relation

* Add test for missing properties

* Fix type annotations in test

* Add property types

* Refactored entity, relation, and property types

* Unused import

* Moved schema to components/ (#96)

* Add entity / Relation extraction component (#85)

* Pipeline  (#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Entity / Relation extraction component

* Adds a Text Splitter (#82)

* Added text splitter adapter class

* Added copyright header to new files

* Added __future__ import to text_splitters.py for backwards compatibility of type hints

* Moved text splitter file and tests

* Split text splitter adapter into 2 adapters

* Added optional metadata to text chunks

* Fixed typos

* Moved text splitters inside of the components folder

* Fixed Component import

* Add tests

* Keep it simple: remove deps to jinja for now

* Update example with existing components

* log config in example

* Fix tests

* Rm unused import

* Add copyright headers

* Rm debug code

* Try and fix tests

* Unused import

* get_type_hints is failing for python 3.8/3.9, even when using __future__ annotations => back to the typing.Dict annotation which is compatible with all python versions

* Return model is also conditioned to the existence of the run method
=> should raise an error if run is not implemented?

* Log when we do not raise exception to keep track of the failure

* Update prompt to match new KGwriter expected type

* Fix test

* Fix type for `examples`

* Use SchemaConfig as input for the ER Extractor component

* The "base" EntityRelationExtractor is an ABC that must be subclassed

* Make node IDs unique across several runs of the pipeline by prefixing them with a timestamp

* Option to build lexical graph in the ERExtractor component

* Fix one test

* Fix some more tests

* Fix some more tests

* Remove "type: ignore" comments

---------

Co-authored-by: willtai <wtaisen@gmail.com>
Co-authored-by: Alex Thomas <alexthomas93@users.noreply.github.com>

* Update lock file after merge

* Remove pipeline/components folder (again)

* Updated component docs (#99)

* Updated component docs

* Removed weaviate test update

* Updated pipeline user guide with link to components in the API section

* Feature/kg builder e2e tests (#98)

* End to end tests for KG builder pipeline

* Adding chunk embedder to the pipeline and e2e tests

* Fix how the chunk embedding is saved

* Fix e2e tests

* Fix mypy

* mypy stuff :'(

* WIP: update e2e tests

* Check counts also here

* Enable e2e tests on this PR only

* Fix e2e tests (was not mocking the correct method for Embedder)

* Revert CI to normal

* Updated CHANGLOG and set max-parallel: 1 for E2E tests in pr-e2e-tests.yaml

---------

Co-authored-by: willtai <wtaisen@gmail.com>
Co-authored-by: Alex Thomas <alexthomas93@users.noreply.github.com>
Co-authored-by: willtai <william.tai@neo4j.com>
stellasia added a commit that referenced this pull request Aug 13, 2024
* Pipeline  (#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Pipeline  (#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Adds a Text Splitter (#82)

* Added text splitter adapter class

* Added copyright header to new files

* Added __future__ import to text_splitters.py for backwards compatibility of type hints

* Moved text splitter file and tests

* Split text splitter adapter into 2 adapters

* Added optional metadata to text chunks

* Fixed typos

* Moved text splitters inside of the components folder

* Fixed Component import

* Added a TextChunkEmbedder (#87)

* Added a TextChunkEmbedder

* Added the copyright header to test_embedder.py

* Updated test_text_chunk_embedder_run

* Adds a knowledge graph writer (#83)

* Added copyright header to new files

* Added copyright header to kg_writer.py

* Added __future__ import to kg_writer.py for backwards compatibility of type hints

* Added E2E test for Neo4jWriter

* Added a copyright header to test_kg_builder_e2e.py

* Added upsert_vector test for relationship embeddings

* Moved KG writer and its tests

* Moved Neo4jGraph and associated objects to a new file

* Renamed KG builder fixture

* Added unit tests for KG writer

* Split upsert_vector into 2 functions

* Fixed broken cypher query strings

* Removed embedding creation from Neo4jWriter

* Fixed setup_neo4j_for_kg_construction fixture

* Added KGWriterModel class

* Fixed minor mistake in test_weaviate_e2e.py

* Renamed kg_construction folder to components

* Updated unit tests with new folder structure

* Fixed broken import

* Fixed copyright headers

* Added missing docstrings

* Fixed typo

* Add documentation for pipeline exceptions (#90)

* Start documentation for KG construction pipeline

* Fixes and refactors the KG writer component (#92)

* Fixes and refactors the KG writer component

* Fixed mypy error

* Made start_node_id and end_node_id parameters in UPSERT_RELATIONSHIP_QUERY

* Add schema for kg builder (#88)

* Add schema for kg builder and tests

* Fixed mypy checks

* Reverted kg builder example with schema

* Revert to List and Dict due to Python3.8 issue with using get_type_hints

* Added properties to Entity and Relation

* Add test for missing properties

* Fix type annotations in test

* Add property types

* Refactored entity, relation, and property types

* Unused import

* Moved schema to components/ (#96)

* Add entity / Relation extraction component (#85)

* Pipeline  (#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Entity / Relation extraction component

* Adds a Text Splitter (#82)

* Added text splitter adapter class

* Added copyright header to new files

* Added __future__ import to text_splitters.py for backwards compatibility of type hints

* Moved text splitter file and tests

* Split text splitter adapter into 2 adapters

* Added optional metadata to text chunks

* Fixed typos

* Moved text splitters inside of the components folder

* Fixed Component import

* Add tests

* Keep it simple: remove deps to jinja for now

* Update example with existing components

* log config in example

* Fix tests

* Rm unused import

* Add copyright headers

* Rm debug code

* Try and fix tests

* Unused import

* get_type_hints is failing for python 3.8/3.9, even when using __future__ annotations => back to the typing.Dict annotation which is compatible with all python versions

* Return model is also conditioned to the existence of the run method
=> should raise an error if run is not implemented?

* Log when we do not raise exception to keep track of the failure

* Update prompt to match new KGwriter expected type

* Fix test

* Fix type for `examples`

* Use SchemaConfig as input for the ER Extractor component

* The "base" EntityRelationExtractor is an ABC that must be subclassed

* Make node IDs unique across several runs of the pipeline by prefixing them with a timestamp

* Option to build lexical graph in the ERExtractor component

* Fix one test

* Fix some more tests

* Fix some more tests

* Remove "type: ignore" comments

---------

Co-authored-by: willtai <wtaisen@gmail.com>
Co-authored-by: Alex Thomas <alexthomas93@users.noreply.github.com>

* Update lock file after merge

* Remove pipeline/components folder (again)

* Updated component docs (#99)

* Updated component docs

* Removed weaviate test update

* Updated pipeline user guide with link to components in the API section

* Feature/kg builder e2e tests (#98)

* End to end tests for KG builder pipeline

* Adding chunk embedder to the pipeline and e2e tests

* Fix how the chunk embedding is saved

* Fix e2e tests

* Fix mypy

* mypy stuff :'(

* WIP: update e2e tests

* Check counts also here

* Enable e2e tests on this PR only

* Fix e2e tests (was not mocking the correct method for Embedder)

* Revert CI to normal

* User guide for KG builder pipeline

* Update line length

* Review comments 1

* Address review comments - add missing file (image)

* Nicer lists

---------

Co-authored-by: willtai <wtaisen@gmail.com>
Co-authored-by: Alex Thomas <alexthomas93@users.noreply.github.com>
Co-authored-by: willtai <william.tai@neo4j.com>
a-s-g93 pushed a commit to a-s-g93/neo4j-genai-python-dev that referenced this pull request Sep 13, 2024
* Pipeline  (neo4j#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Pipeline  (neo4j#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Adds a Text Splitter (neo4j#82)

* Added text splitter adapter class

* Added copyright header to new files

* Added __future__ import to text_splitters.py for backwards compatibility of type hints

* Moved text splitter file and tests

* Split text splitter adapter into 2 adapters

* Added optional metadata to text chunks

* Fixed typos

* Moved text splitters inside of the components folder

* Fixed Component import

* Added a TextChunkEmbedder (neo4j#87)

* Added a TextChunkEmbedder

* Added the copyright header to test_embedder.py

* Updated test_text_chunk_embedder_run

* Adds a knowledge graph writer (neo4j#83)

* Added copyright header to new files

* Added copyright header to kg_writer.py

* Added __future__ import to kg_writer.py for backwards compatibility of type hints

* Added E2E test for Neo4jWriter

* Added a copyright header to test_kg_builder_e2e.py

* Added upsert_vector test for relationship embeddings

* Moved KG writer and its tests

* Moved Neo4jGraph and associated objects to a new file

* Renamed KG builder fixture

* Added unit tests for KG writer

* Split upsert_vector into 2 functions

* Fixed broken cypher query strings

* Removed embedding creation from Neo4jWriter

* Fixed setup_neo4j_for_kg_construction fixture

* Added KGWriterModel class

* Fixed minor mistake in test_weaviate_e2e.py

* Renamed kg_construction folder to components

* Updated unit tests with new folder structure

* Fixed broken import

* Fixed copyright headers

* Added missing docstrings

* Fixed typo

* Add documentation for pipeline exceptions (neo4j#90)

* Fixes and refactors the KG writer component (neo4j#92)

* Fixes and refactors the KG writer component

* Fixed mypy error

* Made start_node_id and end_node_id parameters in UPSERT_RELATIONSHIP_QUERY

* Add schema for kg builder (neo4j#88)

* Add schema for kg builder and tests

* Fixed mypy checks

* Reverted kg builder example with schema

* Revert to List and Dict due to Python3.8 issue with using get_type_hints

* Added properties to Entity and Relation

* Add test for missing properties

* Fix type annotations in test

* Add property types

* Refactored entity, relation, and property types

* Unused import

* Moved schema to components/ (neo4j#96)

* Add entity / Relation extraction component (neo4j#85)

* Pipeline  (neo4j#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Entity / Relation extraction component

* Adds a Text Splitter (neo4j#82)

* Added text splitter adapter class

* Added copyright header to new files

* Added __future__ import to text_splitters.py for backwards compatibility of type hints

* Moved text splitter file and tests

* Split text splitter adapter into 2 adapters

* Added optional metadata to text chunks

* Fixed typos

* Moved text splitters inside of the components folder

* Fixed Component import

* Add tests

* Keep it simple: remove deps to jinja for now

* Update example with existing components

* log config in example

* Fix tests

* Rm unused import

* Add copyright headers

* Rm debug code

* Try and fix tests

* Unused import

* get_type_hints is failing for python 3.8/3.9, even when using __future__ annotations => back to the typing.Dict annotation which is compatible with all python versions

* Return model is also conditioned to the existence of the run method
=> should raise an error if run is not implemented?

* Log when we do not raise exception to keep track of the failure

* Update prompt to match new KGwriter expected type

* Fix test

* Fix type for `examples`

* Use SchemaConfig as input for the ER Extractor component

* The "base" EntityRelationExtractor is an ABC that must be subclassed

* Make node IDs unique across several runs of the pipeline by prefixing them with a timestamp

* Option to build lexical graph in the ERExtractor component

* Fix one test

* Fix some more tests

* Fix some more tests

* Remove "type: ignore" comments

---------

Co-authored-by: willtai <wtaisen@gmail.com>
Co-authored-by: Alex Thomas <alexthomas93@users.noreply.github.com>

* Update lock file after merge

* Remove pipeline/components folder (again)

* Updated component docs (neo4j#99)

* Updated component docs

* Removed weaviate test update

* Updated pipeline user guide with link to components in the API section

* Feature/kg builder e2e tests (neo4j#98)

* End to end tests for KG builder pipeline

* Adding chunk embedder to the pipeline and e2e tests

* Fix how the chunk embedding is saved

* Fix e2e tests

* Fix mypy

* mypy stuff :'(

* WIP: update e2e tests

* Check counts also here

* Enable e2e tests on this PR only

* Fix e2e tests (was not mocking the correct method for Embedder)

* Revert CI to normal

* Updated CHANGLOG and set max-parallel: 1 for E2E tests in pr-e2e-tests.yaml

---------

Co-authored-by: willtai <wtaisen@gmail.com>
Co-authored-by: Alex Thomas <alexthomas93@users.noreply.github.com>
Co-authored-by: willtai <william.tai@neo4j.com>
a-s-g93 pushed a commit to a-s-g93/neo4j-genai-python-dev that referenced this pull request Sep 13, 2024
* Pipeline  (neo4j#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Pipeline  (neo4j#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Adds a Text Splitter (neo4j#82)

* Added text splitter adapter class

* Added copyright header to new files

* Added __future__ import to text_splitters.py for backwards compatibility of type hints

* Moved text splitter file and tests

* Split text splitter adapter into 2 adapters

* Added optional metadata to text chunks

* Fixed typos

* Moved text splitters inside of the components folder

* Fixed Component import

* Added a TextChunkEmbedder (neo4j#87)

* Added a TextChunkEmbedder

* Added the copyright header to test_embedder.py

* Updated test_text_chunk_embedder_run

* Adds a knowledge graph writer (neo4j#83)

* Added copyright header to new files

* Added copyright header to kg_writer.py

* Added __future__ import to kg_writer.py for backwards compatibility of type hints

* Added E2E test for Neo4jWriter

* Added a copyright header to test_kg_builder_e2e.py

* Added upsert_vector test for relationship embeddings

* Moved KG writer and its tests

* Moved Neo4jGraph and associated objects to a new file

* Renamed KG builder fixture

* Added unit tests for KG writer

* Split upsert_vector into 2 functions

* Fixed broken cypher query strings

* Removed embedding creation from Neo4jWriter

* Fixed setup_neo4j_for_kg_construction fixture

* Added KGWriterModel class

* Fixed minor mistake in test_weaviate_e2e.py

* Renamed kg_construction folder to components

* Updated unit tests with new folder structure

* Fixed broken import

* Fixed copyright headers

* Added missing docstrings

* Fixed typo

* Add documentation for pipeline exceptions (neo4j#90)

* Start documentation for KG construction pipeline

* Fixes and refactors the KG writer component (neo4j#92)

* Fixes and refactors the KG writer component

* Fixed mypy error

* Made start_node_id and end_node_id parameters in UPSERT_RELATIONSHIP_QUERY

* Add schema for kg builder (neo4j#88)

* Add schema for kg builder and tests

* Fixed mypy checks

* Reverted kg builder example with schema

* Revert to List and Dict due to Python3.8 issue with using get_type_hints

* Added properties to Entity and Relation

* Add test for missing properties

* Fix type annotations in test

* Add property types

* Refactored entity, relation, and property types

* Unused import

* Moved schema to components/ (neo4j#96)

* Add entity / Relation extraction component (neo4j#85)

* Pipeline  (neo4j#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Entity / Relation extraction component

* Adds a Text Splitter (neo4j#82)

* Added text splitter adapter class

* Added copyright header to new files

* Added __future__ import to text_splitters.py for backwards compatibility of type hints

* Moved text splitter file and tests

* Split text splitter adapter into 2 adapters

* Added optional metadata to text chunks

* Fixed typos

* Moved text splitters inside of the components folder

* Fixed Component import

* Add tests

* Keep it simple: remove deps to jinja for now

* Update example with existing components

* log config in example

* Fix tests

* Rm unused import

* Add copyright headers

* Rm debug code

* Try and fix tests

* Unused import

* get_type_hints is failing for python 3.8/3.9, even when using __future__ annotations => back to the typing.Dict annotation which is compatible with all python versions

* Return model is also conditioned to the existence of the run method
=> should raise an error if run is not implemented?

* Log when we do not raise exception to keep track of the failure

* Update prompt to match new KGwriter expected type

* Fix test

* Fix type for `examples`

* Use SchemaConfig as input for the ER Extractor component

* The "base" EntityRelationExtractor is an ABC that must be subclassed

* Make node IDs unique across several runs of the pipeline by prefixing them with a timestamp

* Option to build lexical graph in the ERExtractor component

* Fix one test

* Fix some more tests

* Fix some more tests

* Remove "type: ignore" comments

---------

Co-authored-by: willtai <wtaisen@gmail.com>
Co-authored-by: Alex Thomas <alexthomas93@users.noreply.github.com>

* Update lock file after merge

* Remove pipeline/components folder (again)

* Updated component docs (neo4j#99)

* Updated component docs

* Removed weaviate test update

* Updated pipeline user guide with link to components in the API section

* Feature/kg builder e2e tests (neo4j#98)

* End to end tests for KG builder pipeline

* Adding chunk embedder to the pipeline and e2e tests

* Fix how the chunk embedding is saved

* Fix e2e tests

* Fix mypy

* mypy stuff :'(

* WIP: update e2e tests

* Check counts also here

* Enable e2e tests on this PR only

* Fix e2e tests (was not mocking the correct method for Embedder)

* Revert CI to normal

* User guide for KG builder pipeline

* Update line length

* Review comments 1

* Address review comments - add missing file (image)

* Nicer lists

---------

Co-authored-by: willtai <wtaisen@gmail.com>
Co-authored-by: Alex Thomas <alexthomas93@users.noreply.github.com>
Co-authored-by: willtai <william.tai@neo4j.com>
a-s-g93 pushed a commit to a-s-g93/neo4j-genai-python-dev that referenced this pull request Sep 13, 2024
* Pipeline  (neo4j#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Pipeline  (neo4j#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Adds a Text Splitter (neo4j#82)

* Added text splitter adapter class

* Added copyright header to new files

* Added __future__ import to text_splitters.py for backwards compatibility of type hints

* Moved text splitter file and tests

* Split text splitter adapter into 2 adapters

* Added optional metadata to text chunks

* Fixed typos

* Moved text splitters inside of the components folder

* Fixed Component import

* Added a TextChunkEmbedder (neo4j#87)

* Added a TextChunkEmbedder

* Added the copyright header to test_embedder.py

* Updated test_text_chunk_embedder_run

* Adds a knowledge graph writer (neo4j#83)

* Added copyright header to new files

* Added copyright header to kg_writer.py

* Added __future__ import to kg_writer.py for backwards compatibility of type hints

* Added E2E test for Neo4jWriter

* Added a copyright header to test_kg_builder_e2e.py

* Added upsert_vector test for relationship embeddings

* Moved KG writer and its tests

* Moved Neo4jGraph and associated objects to a new file

* Renamed KG builder fixture

* Added unit tests for KG writer

* Split upsert_vector into 2 functions

* Fixed broken cypher query strings

* Removed embedding creation from Neo4jWriter

* Fixed setup_neo4j_for_kg_construction fixture

* Added KGWriterModel class

* Fixed minor mistake in test_weaviate_e2e.py

* Renamed kg_construction folder to components

* Updated unit tests with new folder structure

* Fixed broken import

* Fixed copyright headers

* Added missing docstrings

* Fixed typo

* Add documentation for pipeline exceptions (neo4j#90)

* Fixes and refactors the KG writer component (neo4j#92)

* Fixes and refactors the KG writer component

* Fixed mypy error

* Made start_node_id and end_node_id parameters in UPSERT_RELATIONSHIP_QUERY

* Add schema for kg builder (neo4j#88)

* Add schema for kg builder and tests

* Fixed mypy checks

* Reverted kg builder example with schema

* Revert to List and Dict due to Python3.8 issue with using get_type_hints

* Added properties to Entity and Relation

* Add test for missing properties

* Fix type annotations in test

* Add property types

* Refactored entity, relation, and property types

* Unused import

* Moved schema to components/ (neo4j#96)

* Add entity / Relation extraction component (neo4j#85)

* Pipeline  (neo4j#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Entity / Relation extraction component

* Adds a Text Splitter (neo4j#82)

* Added text splitter adapter class

* Added copyright header to new files

* Added __future__ import to text_splitters.py for backwards compatibility of type hints

* Moved text splitter file and tests

* Split text splitter adapter into 2 adapters

* Added optional metadata to text chunks

* Fixed typos

* Moved text splitters inside of the components folder

* Fixed Component import

* Add tests

* Keep it simple: remove deps to jinja for now

* Update example with existing components

* log config in example

* Fix tests

* Rm unused import

* Add copyright headers

* Rm debug code

* Try and fix tests

* Unused import

* get_type_hints is failing for python 3.8/3.9, even when using __future__ annotations => back to the typing.Dict annotation which is compatible with all python versions

* Return model is also conditioned to the existence of the run method
=> should raise an error if run is not implemented?

* Log when we do not raise exception to keep track of the failure

* Update prompt to match new KGwriter expected type

* Fix test

* Fix type for `examples`

* Use SchemaConfig as input for the ER Extractor component

* The "base" EntityRelationExtractor is an ABC that must be subclassed

* Make node IDs unique across several runs of the pipeline by prefixing them with a timestamp

* Option to build lexical graph in the ERExtractor component

* Fix one test

* Fix some more tests

* Fix some more tests

* Remove "type: ignore" comments

---------

Co-authored-by: willtai <wtaisen@gmail.com>
Co-authored-by: Alex Thomas <alexthomas93@users.noreply.github.com>

* Update lock file after merge

* Remove pipeline/components folder (again)

* Updated component docs (neo4j#99)

* Updated component docs

* Removed weaviate test update

* Updated pipeline user guide with link to components in the API section

* Feature/kg builder e2e tests (neo4j#98)

* End to end tests for KG builder pipeline

* Adding chunk embedder to the pipeline and e2e tests

* Fix how the chunk embedding is saved

* Fix e2e tests

* Fix mypy

* mypy stuff :'(

* WIP: update e2e tests

* Check counts also here

* Enable e2e tests on this PR only

* Fix e2e tests (was not mocking the correct method for Embedder)

* Revert CI to normal

* Updated CHANGLOG and set max-parallel: 1 for E2E tests in pr-e2e-tests.yaml

---------

Co-authored-by: willtai <wtaisen@gmail.com>
Co-authored-by: Alex Thomas <alexthomas93@users.noreply.github.com>
Co-authored-by: willtai <william.tai@neo4j.com>
a-s-g93 pushed a commit to a-s-g93/neo4j-genai-python-dev that referenced this pull request Sep 13, 2024
* Pipeline  (neo4j#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Pipeline  (neo4j#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Adds a Text Splitter (neo4j#82)

* Added text splitter adapter class

* Added copyright header to new files

* Added __future__ import to text_splitters.py for backwards compatibility of type hints

* Moved text splitter file and tests

* Split text splitter adapter into 2 adapters

* Added optional metadata to text chunks

* Fixed typos

* Moved text splitters inside of the components folder

* Fixed Component import

* Added a TextChunkEmbedder (neo4j#87)

* Added a TextChunkEmbedder

* Added the copyright header to test_embedder.py

* Updated test_text_chunk_embedder_run

* Adds a knowledge graph writer (neo4j#83)

* Added copyright header to new files

* Added copyright header to kg_writer.py

* Added __future__ import to kg_writer.py for backwards compatibility of type hints

* Added E2E test for Neo4jWriter

* Added a copyright header to test_kg_builder_e2e.py

* Added upsert_vector test for relationship embeddings

* Moved KG writer and its tests

* Moved Neo4jGraph and associated objects to a new file

* Renamed KG builder fixture

* Added unit tests for KG writer

* Split upsert_vector into 2 functions

* Fixed broken cypher query strings

* Removed embedding creation from Neo4jWriter

* Fixed setup_neo4j_for_kg_construction fixture

* Added KGWriterModel class

* Fixed minor mistake in test_weaviate_e2e.py

* Renamed kg_construction folder to components

* Updated unit tests with new folder structure

* Fixed broken import

* Fixed copyright headers

* Added missing docstrings

* Fixed typo

* Add documentation for pipeline exceptions (neo4j#90)

* Start documentation for KG construction pipeline

* Fixes and refactors the KG writer component (neo4j#92)

* Fixes and refactors the KG writer component

* Fixed mypy error

* Made start_node_id and end_node_id parameters in UPSERT_RELATIONSHIP_QUERY

* Add schema for kg builder (neo4j#88)

* Add schema for kg builder and tests

* Fixed mypy checks

* Reverted kg builder example with schema

* Revert to List and Dict due to Python3.8 issue with using get_type_hints

* Added properties to Entity and Relation

* Add test for missing properties

* Fix type annotations in test

* Add property types

* Refactored entity, relation, and property types

* Unused import

* Moved schema to components/ (neo4j#96)

* Add entity / Relation extraction component (neo4j#85)

* Pipeline  (neo4j#81)

* First draft of pipeline/component architecture. Example using the RAG pipeline.

* More complex implementation of pipeline to deal with branching and aggregations - no async yet

* Introduce Store to add flexibility as where to store pipeline results - Only return the leaf components results by default

* Test RAG with new Pipeline implementation

* File refactoring

* Pipeline orchestration with async support

* Import sorting

* Pipeline rerun + exception on cyclic graph (for now)

* Mypy

* Python version compat

* Rename process->run for Components for consistency with Pipeline

* Move components test in the example folder - add some tests

* Race condition fix - documentation - ruff

* Fix import sorting

* mypy on tests

* Mark test as async

* Tests were not testing...

* Ability to create Pipeline templates

* Ruff

* Future + header

* Renaming + update import structure to make it more compatible with rest of the repo

* Check input parameters before starting the pipeline

* Introduce output model for component - Validate pipeline before running - More unit tests

* Import..

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks...

* Finally installed pre-commit hooks... and struggling with pydantic..

* Mypy on examples

* Add missing header

* Update doc

* Fix import in doc

* Update changelog

* Update docs/source/user_guide_pipeline.rst

Co-authored-by: willtai <wtaisen@gmail.com>

* Refactor tests folder to match src structure

* Move exceptions to separate file and rename them to make it clearer they are related to pipeline

* Mypy

* Rename def => config

* Introduce generic type to remove most of the "type: ignore" comments

* Remove unnecessary comment

* Ruff

* Document and test is_cyclic method

* Remove find_all method from store (simplify data retrieval)

* value is not a list anymore (or, if it is, it's on purpose)

* Remove comments, fix example in doc

* Remove core directory - move files to /pipeline

* Expose stores from pipeline subpackage

* Ability to pass the full output of one component to the next one - useful when a component accepts a pydantic model as input

* Component subclasses can return DataModel

* Add note on async + schema to illustrate parameter propagation

---------

Co-authored-by: willtai <wtaisen@gmail.com>

* Entity / Relation extraction component

* Adds a Text Splitter (neo4j#82)

* Added text splitter adapter class

* Added copyright header to new files

* Added __future__ import to text_splitters.py for backwards compatibility of type hints

* Moved text splitter file and tests

* Split text splitter adapter into 2 adapters

* Added optional metadata to text chunks

* Fixed typos

* Moved text splitters inside of the components folder

* Fixed Component import

* Add tests

* Keep it simple: remove deps to jinja for now

* Update example with existing components

* log config in example

* Fix tests

* Rm unused import

* Add copyright headers

* Rm debug code

* Try and fix tests

* Unused import

* get_type_hints is failing for python 3.8/3.9, even when using __future__ annotations => back to the typing.Dict annotation which is compatible with all python versions

* Return model is also conditioned to the existence of the run method
=> should raise an error if run is not implemented?

* Log when we do not raise exception to keep track of the failure

* Update prompt to match new KGwriter expected type

* Fix test

* Fix type for `examples`

* Use SchemaConfig as input for the ER Extractor component

* The "base" EntityRelationExtractor is an ABC that must be subclassed

* Make node IDs unique across several runs of the pipeline by prefixing them with a timestamp

* Option to build lexical graph in the ERExtractor component

* Fix one test

* Fix some more tests

* Fix some more tests

* Remove "type: ignore" comments

---------

Co-authored-by: willtai <wtaisen@gmail.com>
Co-authored-by: Alex Thomas <alexthomas93@users.noreply.github.com>

* Update lock file after merge

* Remove pipeline/components folder (again)

* Updated component docs (neo4j#99)

* Updated component docs

* Removed weaviate test update

* Updated pipeline user guide with link to components in the API section

* Feature/kg builder e2e tests (neo4j#98)

* End to end tests for KG builder pipeline

* Adding chunk embedder to the pipeline and e2e tests

* Fix how the chunk embedding is saved

* Fix e2e tests

* Fix mypy

* mypy stuff :'(

* WIP: update e2e tests

* Check counts also here

* Enable e2e tests on this PR only

* Fix e2e tests (was not mocking the correct method for Embedder)

* Revert CI to normal

* User guide for KG builder pipeline

* Update line length

* Review comments 1

* Address review comments - add missing file (image)

* Nicer lists

---------

Co-authored-by: willtai <wtaisen@gmail.com>
Co-authored-by: Alex Thomas <alexthomas93@users.noreply.github.com>
Co-authored-by: willtai <william.tai@neo4j.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants