{"id":23634609,"url":"https://github.com/aws-samples/amazon-bedrock-client-for-mac","last_synced_at":"2026-03-06T20:32:30.646Z","repository":{"id":200663401,"uuid":"705941587","full_name":"aws-samples/amazon-bedrock-client-for-mac","owner":"aws-samples","description":"A native macOS client that brings Amazon Bedrock's AI models directly to your desktop. Access Claude Sonnet 4.5, Opus 4, and other foundation models through a clean interface designed for macOS, with system-wide quick access and full AWS integration.","archived":false,"fork":false,"pushed_at":"2025-12-02T07:48:03.000Z","size":52655,"stargazers_count":395,"open_issues_count":13,"forks_count":38,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-12-02T15:52:13.779Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit-0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aws-samples.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-10-17T02:10:35.000Z","updated_at":"2025-12-02T07:48:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"399431bd-25d8-4462-b64a-b752db84c694","html_url":"https://github.com/aws-samples/amazon-bedrock-client-for-mac","commit_stats":null,"previous_names":["aws-samples/amazon-bedrock-client-for-mac"],"tags_count":50,"template":false,"template_full_name":"amazon-archives/__template_MIT-0","purl":"pkg:github/aws-samples/amazon-bedrock-client-for-mac","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-samples%2Famazon-bedrock-client-for-mac","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-samples%2Famazon-bedrock-client-for-mac/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-samples%2Famazon-bedrock-client-for-mac/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-samples%2Famazon-bedrock-client-for-mac/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aws-samples","download_url":"https://codeload.github.com/aws-samples/amazon-bedrock-client-for-mac/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-samples%2Famazon-bedrock-client-for-mac/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30196173,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T19:07:06.838Z","status":"ssl_error","status_checked_at":"2026-03-06T18:57:34.882Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2024-12-28T05:01:33.497Z","updated_at":"2026-03-06T20:32:30.620Z","avatar_url":"https://github.com/aws-samples.png","language":"Swift","funding_links":[],"categories":["Swift"],"sub_categories":[],"readme":"# Amazon Bedrock Client for Mac\n\u003cimg width=\"2034\" alt=\"Amazon Bedrock Client for Mac\" src=\"assets/preview.gif\" /\u003e\n\n[![Latest Release](https://img.shields.io/github/v/release/aws-samples/amazon-bedrock-client-for-mac?style=flat-square)](https://github.com/aws-samples/amazon-bedrock-client-for-mac/releases/latest)\n[![Build Status](https://github.com/aws-samples/amazon-bedrock-client-for-mac/workflows/Build/badge.svg)](https://github.com/aws-samples/amazon-bedrock-client-for-mac/actions)\n[![License: MIT-0](https://img.shields.io/badge/License-MIT--0-green.svg?style=flat-square)](https://opensource.org/license/mit-0/)\n[![Platform](https://img.shields.io/badge/platform-macOS-blue.svg?style=flat-square)](https://developer.apple.com/macos/)\n[![Swift Version](https://img.shields.io/badge/Swift-5.9-orange.svg?style=flat-square)](https://swift.org)\n\nA modern, native macOS client for Amazon Bedrock, providing streamlined access to AI models directly from your desktop.\n\n**[Download](#download) • [Features](#features) • [Getting Started](#getting-started) • [Usage](#usage) • [Troubleshooting](#troubleshooting) • [Contributing](#contributing)**\n\n----\n\n## Features\n\n### Model Support\n- Full access to Amazon Bedrock models including Claude 3.7 Sonnet, Llama, Mistral, DeepSeek R1, and Stable Diffusion\n- Support for text generation, image generation, and embedding models\n- Multi-modal capabilities with image upload for Claude 3 models\n- Model Context Protocol (MCP) integration with tool use tracking and execution\n- Enhanced reasoning capabilities with increased token budget (2048 tokens)\n\n### User Experience\n- Clean, native macOS interface with dark mode support\n- Real-time streaming responses with Claude 3.7 thinking support\n- Message history and conversation management\n- In-chat search functionality (Cmd+F)\n- Real-time voice transcription\n- Keyboard shortcuts for font size adjustment, navigation, and sidebar toggle\n- Consistent styling and animations across all views\n\n### Document \u0026 Media Management\n- Expanded functionality to handle both images and documents\n- Document attachment support (PDF, Word, etc.) with proper rendering\n- Modern image viewer modal\n- Image compression and optimization utilities\n\n### Developer Features\n- AWS SSO and credential profile support\n- Multi-region capabilities\n- Custom system prompts and model parameters\n- Code generation with syntax highlighting\n- Unified ConverseStream API for all text generation models\n\n## Download\n\nGet the latest version:\n\n\u003ca href=\"https://github.com/aws-samples/amazon-bedrock-client-for-mac/releases/latest/download/Amazon.Bedrock.Client.for.Mac.dmg\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Download-Latest%20Release-blue?style=for-the-badge\u0026logo=apple\" alt=\"Download Latest Release\" height=\"36\"\u003e\n\u003c/a\u003e\n\n### Homebrew Installation\n\nYou can also install using Homebrew:\n\n```bash\n# Add the tap\nbrew tap didhd/tap\nbrew update\n\n# Install Amazon Bedrock Client\nbrew install amazon-bedrock-client --no-quarantine\n```\n\n## Getting Started\n\n### Requirements\n- macOS 14 or later\n- AWS Account with Bedrock access\n- Configured AWS credentials\n\n### Installation\n1. Download and open the DMG file\n2. Drag the app to your Applications folder\n3. Launch the app and configure your AWS settings (ensure ~/.aws/credentials and ~/.aws/config are properly set up with your access keys or SSO configuration)\n\n\u003e **IMPORTANT:** When opening for the first time, macOS security features will block the application. You'll need to approve it manually in System Preferences \u003e Privacy \u0026 Security by clicking \"Open Anyway\".\n\n\u003cimg width=\"600\" alt=\"Security approval dialog\" src=\"https://github.com/user-attachments/assets/358213a1-2237-4513-96fc-0dd7af9de5e7\" /\u003e\n\n## Usage\n\n### Basic Operation\n1. Select your desired model from the dropdown\n2. Type your message or query\n3. Press Enter or click send\n4. View the AI's response in the conversation view\n\n### Advanced Features\n\n- **Search**: Use Cmd+F to search through conversation history\n- **Voice Input**: Click the microphone for speech-to-text\n- **Image Upload**: Use the image button for visual inputs (Claude 3)\n- **Document Upload**: Attach PDFs and other document formats\n- **Model Settings**: Configure system prompts and parameters\n- **AWS Profiles**: Switch between different credential profiles\n- **Sidebar Toggle**: Use keyboard shortcut to show/hide sidebar\n\n## Troubleshooting\n\nFor common issues and solutions, see our [Troubleshooting Guide](TROUBLESHOOTING.md).\n\n### Common Issues\n- AWS credential recognition problems\n- Model access permissions\n- Image generation formatting requirements\n- Nova models compatibility (fixed in v1.2.11)\n\n## Contributing\n\nWe welcome contributions from the community:\n\n1. Fork the repository\n2. Create a feature branch\n3. Submit a pull request\n\n## License\n\nLicensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=aws-samples/amazon-bedrock-client-for-mac\u0026type=Date)](https://star-history.com/#aws-samples/amazon-bedrock-client-for-mac\u0026Date)\n\n---\n\n\u003cdiv align=\"center\"\u003e\nDeveloped by the AWS Community\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-samples%2Famazon-bedrock-client-for-mac","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faws-samples%2Famazon-bedrock-client-for-mac","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-samples%2Famazon-bedrock-client-for-mac/lists"}