{"id":25644680,"url":"https://github.com/suiware/ai-tools","last_synced_at":"2025-04-15T09:34:15.526Z","repository":{"id":276754250,"uuid":"928350619","full_name":"suiware/ai-tools","owner":"suiware","description":"Sui tools for Vercel AI SDK","archived":false,"fork":false,"pushed_at":"2025-04-11T13:53:44.000Z","size":199,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-11T14:51:08.342Z","etag":null,"topics":["ai","ai-sdk","ai-tools","library","sui","suiware","suiware-ai-tools","vercel-ai-sdk"],"latest_commit_sha":null,"homepage":"https://npmjs.com/package/@suiware/ai-tools","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/suiware.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,"zenodo":null}},"created_at":"2025-02-06T13:48:28.000Z","updated_at":"2025-04-11T13:40:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"7829f206-9cb5-4fe9-a12f-f436953b6a00","html_url":"https://github.com/suiware/ai-tools","commit_stats":null,"previous_names":["suiware/ai-tools"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suiware%2Fai-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suiware%2Fai-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suiware%2Fai-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suiware%2Fai-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/suiware","download_url":"https://codeload.github.com/suiware/ai-tools/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249042945,"owners_count":21203383,"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","ai-sdk","ai-tools","library","sui","suiware","suiware-ai-tools","vercel-ai-sdk"],"created_at":"2025-02-23T08:29:54.224Z","updated_at":"2025-04-15T09:34:15.520Z","avatar_url":"https://github.com/suiware.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sui tools for Vercel AI SDK (monorepo)\n\nPluggable tools for [Vercel AI SDK](https://sdk.vercel.ai/) which allow AI assistants to interact with Sui Network and perform various actions.\n\n## Packages\n\n- [@suiware/ai-tools](packages/tools/README.md) - a collection of pluggable [tools](https://sdk.vercel.ai/docs/foundations/tools) for [Vercel AI SDK](https://sdk.vercel.ai/), which allow AI assistants to interact with Sui Network and perform various actions.\n\n- [Examples](packages/examples/README.md) - examples of AI assistants, demonstrating `@suiware/ai-tools` in action.\n\n## Available tools\n\n### suiAddressTool\n\nGets user address.\n\nExamples:\n- `get my address`\n\n### suiWalletBalanceTool\n\nGets non-zero wallet balances.\n\nExamples:\n- `get my wallet balances`\n- `my balances`\n\n### suiTransferTool\n\nTransfer the amount of the specified coin to the specified address.\n\nExamples:\n- `transfer 1 sui to 0x1234567890abcdef`\n- `send 10 wal to 0x1234567890abcdef`\n- `donate 1 sui to @abcdef1234567890`\n- `throw 1 sui to abcdef1234567890.sui`\n\nSupported coins are listed [here](/packages/tools/src/core/config/coins.ts)\n\n### suiSwapTool (mainnet only)\n\nPerforms coin swap. Supported coins are listed [here](/packages/tools/src/core/config/coins.ts)\n\nExamples:\n- `swap 1 sui for usdc`\n- `convert 10 usdc to sui`\n- `swap 1 sui for weth`\n\n### vixTool\n\nGets the current CBOE Volatility Index (VIX) index value.\n\nExamples:\n- `get current cboe vix`\n- `get vix`\n\nCheck the [source code](/packages/tools/src/ai/tools) of the tools.\n\n## Available examples\n\n|Example|Model|Description|\n|---|---|---|\n|[Simple balance tool](/packages/examples/src/anthropic-simple-balance.ts)| Anthropic: claude-3-5-sonnet-latest | Gets Sui wallet balance, no interactivity |\n|[Interactive agent (text streaming)](/packages/examples/src/anthropic-streaming.ts)| Anthropic: claude-3-5-sonnet-latest | Portfolio management agent with [all tools](#available-tools) enabled |\n|[Interactive agent (text streaming)](/packages/examples/src/openai-streaming.ts) | OpenAI: gpt-3.5-turbo | Portfolio management agent with [all tools](#available-tools) enabled |\n|[Interactive agent (text generating)](/packages/examples/src/openai-generating.ts)| OpenAI: gpt-3.5-turbo | Portfolio management agent with [all tools](#available-tools) enabled |\n|[Interactive agent (text generating)](/packages/examples/src/google-streaming.ts)| Google: gemini-2.0-flash-001 | Portfolio management agent with [all tools](#available-tools) enabled |\n\n## How to use examples\n\n### 1. Install dependencies\n\n```bash\npnpm install\n```\n\n### 2. Configure environment variables\n\n```bash\ncp packages/examples/.env.example packages/examples/.env\n```\n\nThen update the environment variables in the `packages/examples/.env` file.\n\n### 3. Run examples\n\n```bash\npnpm start:anthropic:simple:balance\n# or\npnpm start || pnpm start:anthropic:streaming\n# or \npnpm start:openai:streaming\n# or\npnpm start:openai:generating\n# or \npnpm start:google:streaming\n```\n\n## How to contribute\n\nLearn the simple [packages/tools](/packages/tools/) package and contribute your own tool by sending a PR to this repository. \nIt can be an integration with pools, lending protocols, or any other services that can be beneficial for building AI assistants for Sui.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuiware%2Fai-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuiware%2Fai-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuiware%2Fai-tools/lists"}