https://github.com/dcspark/shinkai-node
Shinkai is a two click install AI manager (Ollama compatible for Windows, Mac and Linux). It lets you download/use AI models, RAG, and performs actions for you with tooling (very soon).
https://github.com/dcspark/shinkai-node
ai chatgpt gui llama3 llm ollama qwen rag
Last synced: 4 months ago
JSON representation
Shinkai is a two click install AI manager (Ollama compatible for Windows, Mac and Linux). It lets you download/use AI models, RAG, and performs actions for you with tooling (very soon).
- Host: GitHub
- URL: https://github.com/dcspark/shinkai-node
- Owner: dcSpark
- License: other
- Created: 2023-06-26T00:55:29.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-13T15:29:45.000Z (4 months ago)
- Last Synced: 2025-03-14T04:48:57.547Z (4 months ago)
- Topics: ai, chatgpt, gui, llama3, llm, ollama, qwen, rag
- Language: Rust
- Homepage: https://shinkai.com
- Size: 109 MB
- Stars: 43
- Watchers: 6
- Forks: 9
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Shinkai Node
The Shinkai Node is the central unit within the Shinkai Network that links user devices and oversees AI agents. Its diverse functions include processing user inputs, managing AI models, handling external containerized tooling for AI, coordinating computing tasks, generating proofs, converting and indexing data into vector embeddings, and ensuring efficient task execution according to user needs. The nodes play a crucial role in maintaining the network's decentralized structure, which enhances both security and privacy.
There is a companion repo called Shinkai Apps, that allows you to locally run the node and also easily manage AI models using Ollama, you can find it here.
[](https://wiki.mutable.ai/dcSpark/shinkai-node)
## Documentation
General Documentation: [https://docs.shinkai.com](https://docs.shinkai.com)
More In Depth Codebase Documentation (Mutable.ai): [https://wiki.mutable.ai/dcSpark/shinkai-node](https://wiki.mutable.ai/dcSpark/shinkai-node)
## Installation (Local Compilation)
### Prerequisites
- Rust version >= 1.81 (required for `std::fs::exists` functionality)
Please refer to the installation instructions for your operating system:
- [Windows Installation Instructions](docs/installation/windows.md)
- [Linux Installation Instructions](docs/installation/linux.md)
- [macOS Installation Instructions](docs/installation/macos.md)
## Build
### Easy Build
```
sh scripts/run_node_localhost.sh
```
if you want to restart the node, you can delete the folder `storage` and run the build again. More information at [https://docs.shinkai.com/getting-started](https://docs.shinkai.com/getting-started).
### Build Shinkai Rust Node
```
cargo build
```
Note: You must run this command from the root directory of this repo and make sure that you have set the required ENV variables.
## OpenAPI
### Generate schemas
Run the following command to generate the schema files:
```
cargo run --example generate_openapi_docs
```
The result will be placed in the folder `docs/openapi`.
### Swagger UI
```
http://{NODE_IP}:{NODE_API_PORT}/v2/swagger-ui/
```
## Tests
Note: You must run these tests from the root directory of this repo.
### Test Shinkai Rust Node Only
Simply use the following to run all rust node tests:
```
IS_TESTING=1 cargo test -- --test-threads=1
```
For running a specific test (useful for debugging) you can use:
```
IS_TESTING=1 cargo test tcp_node_test -- --nocapture --test-threads=1
```
### Running Dockerized Tests
#### Main tests
```
# Build testing image
docker build -t testing_image -f .github/Dockerfile .
# Run tests main cargo tests
docker run --entrypoint /entrypoints/run-main-cargo-tests.sh testing_image
```
### Further CI Development
Use `act -j test-wasm -P self-hosted=nektos/act-environments-ubuntu:18.04 --container-architecture linux/amd64` to run the tests locally in a docker container. This is useful for debugging CI issues.
## Releasing a New Version
When releasing a new version, ensure that you update the `Cargo.toml` of the shinkai-node as well as the `Cargo.toml` of the shinkai-libs/shinkai-http-api library.