← Open Source
johnbean393

Sidekick

A native macOS app that allows users to chat with a local LLM that can respond with information from files, folders and websites on your Mac without installing any other software. Powered by llama.cpp.

ApplicationsPersonalSwift
Open on GitHub
Momentum
+0stars in 24 hours0.0%
3.32k
Stars
149
Forks
+2
This week
5
Contributors
Created 2024-10-09 · Updated 2026-10-13 · #7996 today
Top developers
johnbean393mikedg1Arcadi4

johnbean393/Sidekick is ranked 7,996 with 3,320 stars.

Same-category comparison

johnbean393/Sidekick is ranked 7,996 among these 8 peers; guangzhengli/ChatFiles is ranked 7,994.

Same-category comparison
NameRankMetrics
agentheroes/agentheroes7,985
Language:
TypeScript
Stars:
3,347
Forks:
78
Description:
Generate, animate and schedule your AI characters 🤖.
xenova/whisper-web7,987
Language:
TypeScript
Stars:
3,346
Forks:
433
Description:
ML-powered speech recognition directly in your browser.
fuxicodex/Fuxi7,988
Language:
Python
Stars:
3,342
Forks:
229
guangzhengli/ChatFiles7,994
Language:
TypeScript
Stars:
3,335
Forks:
459
deep-diver/LLM-As-Chatbot8,001
Language:
Python
Stars:
3,315
Forks:
374
Description:
LLM as a Chatbot Service.
errbotio/errbot8,003
Language:
Python
Stars:
3,311
Forks:
625
Description:
Errbot is a chatbot, a daemon that connects to your favorite chat service and bring your tools and some fun into the conversation.
X-D-Lab/LangChain-ChatGLM-Webui8,005
Language:
Python
Stars:
3,310
Forks:
491
arielf/weight-loss8,010
Language:
Python
Stars:
3,301
Forks:
143
Description:
Machine Learning meets ketosis: how to effectively lose weight.
Key parameters and specifications
Key parameters and specifications
ParameterValue
LanguageSwift
CategoryApplications
SubcategoryPersonal
KeywordsLocalAI
Stars3,320
Forks149
Contributors5
Created date2024-10-09
Updated date2026-10-13
Stars in 1 day0
Stars in 7 days2
Rank7,996
Previous rank8,094
Rank change98
7-day stars rank7,676
Previous 7-day stars rank6,681
7-day stars rank change-995
Total stars rank4,111
Previous total stars rank4,107
Total stars rank change-4
README summary

Sidekick Chat with a local LLM that can respond with information from your files, folders and websites on your Mac without installing any other software. All conversations happen offline, and your data stays secure. Sidekick is a local first application –– with a built in inference engine for local models, while accommodating OpenAI compatible APIs for additional model options. Sidekick supports modern GGUF local models such as Qwen3. 5 out of the box through its built-in backend. Example Use Let

’s say you're collecting evidence for a History paper about interactions between Aztecs and Spanish troops, and you’re looking for text about whether the Aztecs used captured Spanish weapons. Here, you can ask Sidekick, “Did the Aztecs use captured Spanish weapons? ”, and it responds with direct quotes with page numbers and a brief analysis. To verify Sidekick’s answer, just click on the references displayed below Sidekick’s answer, and the academic paper referenced by Sidekick immediately opens in

your viewer. Features Read more about Sidekick's features and how to use them here. Resource Use Sidekick accesses files, folders, and websites from your experts, which can be individually configured to contain resources related to specific areas of interest. Activating an expert allows Sidekick to fetch and reference materials as needed. Because Sidekick uses RAG (Retrieval Augmented Generation), you can theoretically put unlimited resources into each expert, and Sidekick will still find information relevant to your request to aid its

analysis. For example, a student might create the experts , , , and . In the image below, he has activated the expert . Users can also give Sidekick access to files just by dragging them into the input field. Sidekick can even respond with the latest information using **web search**, speeding up research. Bring Your Own API Key In addition to its core local-first capabilities, Sidekick allows you to bring your own key for OpenAI compatible APIs. This allows you to tap into

additional remote models while still preserving a primarily local-first workflow. Function Calling Sidekick can call functions to boost the mathematical and logical capabilities of models, and to execute actions. Functions are called sequentially in a loop until a result is obtained. For example, when asking Sidekick to calculate Q3 2025 financial metrics for Nvidia, it makes **27** tool calls, saves the CSV file and presents the results. When telling Sidekick to draft an invitation email for a birthday celebration

to my friend Jean, Sidekick finds my birthday and Jean's email address from my contacts book, and creates a draft in my default email client. This enables agents running fully locally. Deep Research Deep Research is a specific agent implemented in Sidekick to handle long horizon, multi-step research tasks. Specify a research topic, and let Sidekick do the rest –– reading 50-80 webpages, and synthesizing information to prepare a research report. Memory Sidekick can now remember helpful information between

conversations, making its responses more relevant and personalized. Whether you're typing, speaking, or generating images in Sidekick, it can recall

Frequently asked questions

How many stars and forks are recorded?

johnbean393/Sidekick has 3,320 stars and 149 forks.

What is the repository rank?

johnbean393/Sidekick is ranked 7,996.

What language and category are recorded?

johnbean393/Sidekick has 3,320 stars, uses Swift and belongs to Applications.

Which repository is closest in rank?

johnbean393/Sidekick is compared with guangzhengli/ChatFiles, ranked 7,994 with 3,335 stars.

README
 ![Logo](https://raw.githubusercontent.com/johnbean393/Sidekick/refs/heads/main/Docs%20Images/appIcon.png) 

Sidekick

Chat with a local LLM that can respond with information from your files, folders and websites on your Mac without installing any other software. All conversations happen offline, and your data stays secure. Sidekick is a local first application –– with a built in inference engine for local models, while accommodating OpenAI compatible APIs for additional model options.

Sidekick supports modern GGUF local models such as Qwen3.5 out of the box through its built-in llama.cpp backend.

Example Use

Let’s say you're collecting evidence for a History paper about interactions between Aztecs and Spanish troops, and you’re looking for text about whether the Aztecs used captured Spanish weapons.

Here, you can ask Sidekick, “Did the Aztecs use captured Spanish weapons?”, and it responds with direct quotes with page numbers and a brief analysis.

To verify Sidekick’s answer, just click on the references displayed below Sidekick’s answer, and the academic paper referenced by Sidekick immediately opens in your viewer.

Features

Read more about Sidekick's features and how to use them here.

Resource Use

Sidekick accesses files, folders, and websites from your experts, which can be individually configured to contain resources related to specific areas of interest. Activating an expert allows Sidekick to fetch and reference materials as needed.

Because Sidekick uses RAG (Retrieval Augmented Generation), you can theoretically put unlimited resources into each expert, and Sidekick will still find information relevant to your request to aid its analysis.

For example, a student might create the experts English Literature, Mathematics, Geography, Computer Science and Physics. In the image below, he has activated the expert Computer Science.

Users can also give Sidekick access to files just by dragging them into the input field.

Sidekick can even respond with the latest information using web search, speeding up research.

Bring Your Own API Key

In addition to its core local-first capabilities, Sidekick allows you to bring your own key for OpenAI compatible APIs. This allows you to tap into additional remote models while still preserving a primarily local-first workflow.

Sidekick ships with built-in presets for popular providers, including OpenAI, Anthropic, Google AI Studio, DeepSeek, Groq, MiniMax, Mistral, xAI, and more — just select a provider and enter your API key to get started.

Function Calling

Sidekick can call functions to boost the mathematical and logical capabilities of models, and to execute actions. Functions are called sequentially in a loop until a result is obtained.

For example, when asking Sidekick to calculate Q3 2025 financial metrics for Nvidia, it makes 27 tool calls, saves the CSV file and presents the results.

When telling Sidekick to draft an invitation email for a birthday celebration to my friend Jean, Sidekick finds my birthday and Jean's email address from my contacts book, and creates a draft in my default email client.

This enables agents running fully locally.

Deep Research

Deep Research is a specific agent implemented in Sidekick to handle long horizon, multi-step research tasks.

Specify a research topic, and let Sidekick do the rest –– reading 50-80 webpages, and synthesizing information to prepare a research report.

Memory

Sidekick can now remember helpful information between conversations, making its responses more relevant and personalized. Whether you're typing, speaking, or generating images in Sidekick, it can recall details and preferences you’ve shared and use them to tailor its responses. The more you use it, the more useful it becomes, and you’ll start to notice improvements over time.

For example, I might tell Sidekick that I am a beginner in Python trying to create my own version of Tetris.

When I ask it about pygame alternatives, it makes recommendations based on my current project, Tetris.

Canvas

Create, edit and preview websites, code and other textual content using Canvas.

Select parts of the text, then prompt the chatbot to perform selective edits.

Image Generation

Sidekick can generate images from text, allowing you to create visual aids for your work.

There are no buttons, no switches to flick, no Image Generation mode. Instead, a built-in CoreML model automatically identifies image generation prompts, and generates an image when necessary.

Image generation is available on macOS 15.2 or above, and requires Apple Intelligence.

Advanced Markdown Rendering

Markdown is rendered beautifully in Sidekick.

LaTeX

Sidekick offers native LaTeX rendering for mathematical equations.

Data Visualization

Visualizations are automatically generated for tables when appropriate, with a variety of charts available, including bar charts, line charts and pie charts.

Charts can be dragged and dropped into third party apps.

Code

Code is beautifully rendered with syntax highlighting, and can be exported or copied at the click of a button.

Fast Generation

Sidekick uses llama.cpp as its inference backend, which is optimized to deliver lightning fast generation speeds on Apple Silicon. It also supports speculative decoding, which can further improve the generation speed.

Optionally, you can offload generation to speed up processing while extending the battery life of your MacBook.

Installation

Requirements

  • A Mac with Apple Silicon
  • RAM ≥ 8 GB

Via Homebrew

brew install --cask arcadi4/tap/sidekick-ai

Download and Setup

  • Follow the guide here.

Goals

The main goal of Sidekick is to make open, local, private, and contextually aware AI applications accessible to the masses.

Read more about our mission here.

Developer Setup

Requirements

  • A Mac with Apple Silicon
  • RAM ≥ 8 GB

Developer Setup Instructions

  1. Clone this repository.
  2. Run ./setup.sh to change the team in the Xcode project.
  3. Open and run in Xcode.

Contributing

Contributions are very welcome. Let's make Sidekick simple and powerful.

Contact

Contact this repository's owner at , or file an issue.

Credits

This project would not be possible without the hard work of:

  • psugihara and contributors who built FreeChat, which this project took heavy inspiration from
  • Georgi Gerganov for llama.cpp
  • Alibaba for training Qwen 2.5
  • Meta for training Llama 3
  • Google for training Gemma 3

Star History

Nearby in the ranking
Similar items