{"id":14964707,"url":"https://github.com/dcspark/shinkai-apps","last_synced_at":"2025-04-04T23:06:54.823Z","repository":{"id":243106115,"uuid":"685141528","full_name":"dcSpark/shinkai-apps","owner":"dcSpark","description":"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).","archived":false,"fork":false,"pushed_at":"2025-03-27T22:11:45.000Z","size":91668,"stargazers_count":180,"open_issues_count":14,"forks_count":27,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-03-27T23:01:33.149Z","etag":null,"topics":["ai","chatgpt","inference-ui","llama3","llm","llms","local-ai"],"latest_commit_sha":null,"homepage":"https://shinkai.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dcSpark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-30T15:49:34.000Z","updated_at":"2025-03-27T22:11:46.000Z","dependencies_parsed_at":"2024-07-17T22:02:02.916Z","dependency_job_id":"170f701a-480a-44d8-a987-33505725a1a6","html_url":"https://github.com/dcSpark/shinkai-apps","commit_stats":{"total_commits":282,"total_committers":6,"mean_commits":47.0,"dds":0.6808510638297872,"last_synced_commit":"87ad7be1ef97abe6a40defe53f46b5cfa3b35e04"},"previous_names":["dcspark/shinkai-apps"],"tags_count":66,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcSpark%2Fshinkai-apps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcSpark%2Fshinkai-apps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcSpark%2Fshinkai-apps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcSpark%2Fshinkai-apps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dcSpark","download_url":"https://codeload.github.com/dcSpark/shinkai-apps/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247261600,"owners_count":20910108,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","chatgpt","inference-ui","llama3","llm","llms","local-ai"],"created_at":"2024-09-24T13:33:40.348Z","updated_at":"2025-04-04T23:06:54.817Z","avatar_url":"https://github.com/dcSpark.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg width=\"36\" height=\"36\" src=\"assets/icon.png\"/\u003e\u003cbr/\u003e\n  Shinkai apps\n\u003c/h1\u003e\n\u003cp align=\"center\"\u003eShinkai apps unlock the full capabilities/automation of first-class LLM (AI) support in the web browser. It enables creating multiple agents, each connected to either local or 3rd-party LLMs (ex. OpenAI GPT), which have permissioned (meaning secure) access to act in every webpage you visit.\n\u003cbr/\u003e\n\u003cbr/\u003e\nThere is a companion repo called Shinkai Node, that allows you to set up the node anywhere as the central unit of the Shinkai Network, handling tasks such as agent management, job processing, and secure communications. \nYou can find it \u003ca href=\"https://github.com/dcSpark/shinkai-node\"\u003ehere\u003c/a\u003e.\u003c/p\u003e\u003cbr/\u003e\n\n[![Mutable.ai Auto Wiki](https://img.shields.io/badge/Auto_Wiki-Mutable.ai-blue)](https://wiki.mutable.ai/dcSpark/shinkai-apps)\n\n## Demo\n\nhttps://github.com/user-attachments/assets/bc5bb7da-7ca5-477d-838a-8239951b6c01\n\n\n## Documentation\n\nGeneral Documentation: [https://docs.shinkai.com](https://docs.shinkai.com)\n\nMore In Depth Codebase Documentation (Mutable.ai): [https://wiki.mutable.ai/dcSpark/shinkai-apps](https://wiki.mutable.ai/dcSpark/shinkai-apps)\n\n## Projects\n\n### Apps\n\n- shinkai-visor: Shinkai Visor is a chrome extension to interact with shinkai-node.\n- shinkai-desktop: Shinkai Desktop is a desktop app to interact with shinkai-node.\n\n### Libs\n\n- shinkai-message-ts: Typescript library that implements the features and networking layer to enable systems to interact with shinkai-nodes.\n- shinkai-node-state: Typescript library which using @tanstack/react-query enables apps to interact with shinkai-node managing the state, caching and evictions.\n- shinkai-ui: React UI library to build shinkai apps.\n\n## Getting started\n\nTo get started first clone this repo:\n\n```\n$ git clone https://github.com/dcSpark/shinkai-apps\n```\n\n### Download side binaries:\n\n#### Macos\n```\nARCH=\"aarch64-apple-darwin\" \\\nOLLAMA_VERSION=\"v0.6.3\" \\\nSHINKAI_NODE_VERSION=\"v0.9.16\" \\\nnpx ts-node ./ci-scripts/download-side-binaries.ts\n```\n\n#### Linux\n```\nARCH=\"x86_64-unknown-linux-gnu\" \\\nOLLAMA_VERSION=\"v0.6.3\" \\\nSHINKAI_NODE_VERSION=\"v0.9.16\" \\\nnpx ts-node ./ci-scripts/download-side-binaries.ts\n```\n\n#### Windows\n```\n$ENV:OLLAMA_VERSION=\"v0.6.3\";\n$ENV:SHINKAI_NODE_VERSION=\"v0.9.16\";\n$ENV:ARCH=\"x86_64-pc-windows-msvc\";\nnpx ts-node ./ci-scripts/download-side-binaries.ts\n```\n\n### Run one of the projects\nOnce you have done that simply use `npm` to compile/serve it yourself:\n\n```\ncd shinkai-apps\nnvm use\nnpm ci\nnpx nx serve {project-name} # IE: npx nx serve shinkai-desktop\n```\n\n### Project specific configurations\n\n- shinkai-visor: As this is a Chrome Extension, after build, developers needs to load it in chrome:\n\n  1. Open Chrome.\n  2. Navigate to `chrome://extensions`.\n  3. Enable _Developer mode_.\n  4. Click _Load unpacked_.\n  5. Select the `./dist/apps/shinkai-visor` folder which contains the output of the building process using commands like `npx nx serve shinkai-visor`.\n\n- shinkai-desktop: For development and building purposes\n  - Run as a Desktop App using Vite:\n    Run `npx nx serve:tauri shinkai-desktop` and it will automatically launch the Shinkai Desktop application.\n  - Run as a Web App:\n    Run `npx nx serve shinkai-desktop` and open a browser and navigate to `http://localhost:1420`.\n\n### Useful Commands\n\nEvery command, if it's needed, build projects and it's dependencies according to the project dependency tree inferred from imports between them.\n\n- Run a single task\n\n  Command: `npx nx [target] [project-name]`\n\n  Params:\n\n  - target: build | serve | lint | test | e2e\n\n  IE:\n\n  - `npx nx build shinkai-visor`\n  - `npx nx lint shinkai-message-ts`\n  - `npx nx e2e shinkai-visor`\n  - `npx nx serve shinkai-desktop`\n\n- Run many tasks\n\n  Command: `npx nx run-many --target=[target]`\n\n  Params:\n\n  - target: build | serve | lint | test | e2e\n\n  IE:\n\n  - `npx nx run-many --target=build`\n  - `npx nx run-many --target=lint`\n  - `npx nx run-many --target=test`\n  - `npx nx run-many --target=e2e`\n  - `npx nx run-many --target=serve`\n\n- Run on affected projects\n\n  Command: `npx nx affected --target=[target]`\n\n  Params:\n\n  - target: build | serve | lint | test | e2e\n\n  IE:\n\n  - `npx nx affected --target=build`\n\n\u003e When you build a project, NX builds a cache (to make it faster), if you want to skip it just add the parameter `--skip-nx-cache` to the previous commands.\n\n- Create a dev build\n  - `NODE_OPTIONS=\"--max_old_space_size=8192\" npx nx build shinkai-desktop --config=\"./src-tauri/tauri.conf.development.json\"`\n\n## Dev conventions\n\n### Monorepo\n\nTo orchestrate all the tasks, dependencies and hierarchy between different projects, this repository uses [NX](https://nx.dev/) as a monorepo tooling.\n\n### Third party dependencies\n\nAll projects share the same base of dependencies defined `./package.json` file found in the root of the repository. Nested package json files are used just to override or extends base attributes.\n\n### UI Libraries\n\nTo build the UI there are 3 core libraries:\n\n- [radix](https://www.radix-ui.com/) to have base unstyled components.\n- [shadcn](https://ui.shadcn.com/) to obtain ready to use components.\n- [tailwindcss](https://tailwindui.com/) to implement css customizations, structures, layouts and helpers.\n\n### State management\n\nTo implement state management there are two different libraries:\n\n- [zustand](https://docs.pmnd.rs/zustand/getting-started/introduction): To implement UI State\n- [react-query](https://tanstack.com/query/v4): To implement data state\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdcspark%2Fshinkai-apps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdcspark%2Fshinkai-apps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdcspark%2Fshinkai-apps/lists"}