https://github.com/qubitpi/nexusgraph
⭐ Natural language text to knowledge graph
https://github.com/qubitpi/nexusgraph
knowledge-graph natural-language-processing nlp react reactjs
Last synced: about 2 months ago
JSON representation
⭐ Natural language text to knowledge graph
- Host: GitHub
- URL: https://github.com/qubitpi/nexusgraph
- Owner: QubitPi
- License: apache-2.0
- Created: 2025-01-26T09:14:28.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2025-02-05T10:32:02.000Z (3 months ago)
- Last Synced: 2025-03-15T23:05:48.512Z (about 2 months ago)
- Language: TypeScript
- Homepage: https://nexusgraph.qubitpi.org/
- Size: 17.6 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Nexus Graph
- [Nexus Graph](#nexus-graph)
- [Development](#development)
- [Getting Source Code](#getting-source-code)
- [Scripts](#scripts)
- [Automatically Formatting Codebase](#automatically-formatting-codebase)
- [Application Monitoring](#application-monitoring)
- [License](#license)
## Development
Nexus Graph has the following packages:
- [`nexusgraph-app`](packages/nexusgraph-app): holding business logics of the app
- [`nexusgraph-redux`](packages/nexusgraph-redux): managing all app states. Nexus Graph uses
[Redux state management][Redux]
[][Redux]
instead of ~~[React state management][useState]~~ for a much more maintainable decoupling of React components
### Getting Source Code
```console
git clone [email protected]:QubitPi/nexusgraph.git
cd nexusgraph
```
Install dependencies by
> [!NOTE]
>
> Node 22 and Yarn 2 must be installed in local environment.
```console
yarn
```
### Scripts
- `yarn start`: Runs the app in development mode. Open http://localhost:3000 to view it in the browser. The page automatically reloads
if we make changes to the code. we will see the build errors and lint warnings in the console.
- `yarn test`: Runs the unit tests
- `yarn cypress:open` & `yarn e2e`: Opens Cypress End-to-End test console and runs the End-to-End tests, respectively
- `yarn build`: Builds the app for production to the build folder. It correctly bundles React in production mode and
optimizes the build for the best performance. The build is minified and the filenames include the hashes.
### Automatically Formatting Codebase
When CI/CD complains about "Code style check" as the following:
Simply run the following command at project root which will auto formatting the codebase using Prettier:
```console
yarn prettier --ignore-path .gitignore . --write
```
> [!TIP]
>
> It's always a good practice to auto-formatting code whenever convenient 
## Application Monitoring
sentry.io has been integrated into the [nexusgraph.qubitpi.org](https://nexusgraph.qubitpi.org/). Specifically:
- [sourcemap](https://docs.sentry.io/platforms/javascript/legacy-sdk/sourcemaps/) is uploaded to sentry during build time
- error trace are sent to sentry during run time
While error trace will always be sent in production mode (`process.env.NODE_ENV === "production"`), an
[.env.sentry-build-plugin](https://docs.sentry.io/platforms/javascript/sourcemaps/uploading/webpack/) is, however,
required for `yarn build` to be able to generate and upload the sourcemap.
> [!NOTE]
>
> If the `.env.sentry-build-plugin` is not present, `yarn build` will still run successfully. It's just not possible
> then to locate the exact location of error in code on sentry issue console because sourcemap hasn't been uploaded
## License
The use and distribution terms for [nexusgraph]() are covered by the [Apache License, Version 2.0](./LICENSE).
[Redux]: https://react-redux.qubitpi.org/
[useState]: https://react.qubitpi.org/reference/react/useState