Table of Contents
What You’ll Build in 10 Minutes
You’ll create a personal AI assistant named MyHelper that:
- Answers questions about your documents or notes
- Runs locally on your machine (no cloud needed)
- Works offline once trained
- Can be extended with new skills later
By the end, you’ll have a privacy-first AI that understands your context—your files, your tone, your knowledge.
Prerequisites (2 minutes)
Before we start, install the following (all free):
- Python 3.11 or newer – python.org
- Git – git-scm.com
- pip (comes with Python)
💡 Tip: On macOS/Linux, use
python3 -m pipinstead ofpipto avoid conflicts.
You’ll also need one folder with some text files (like notes, PDFs, or .txt files). Gather at least 5 small documents for best results.
Step 1: Install Assisters (1 minute)
Assisters is a new open-source toolkit released in early 2026. We’ll use assisters-cli, a command-line tool that does most of the work.
Run this in your terminal:
pip install assister-cli --upgrade
✅ Verify it works:
bashassister --versionShould print something like
assister-cli 0.2.1
Now create a project folder:
mkdir my-assister
cd my-assister
Step 2: Bootstrap Your Assistant (2 minutes)
Initialize your assistant with a name and default settings:
assister init --name MyHelper --model small
This creates:
assister.yaml– your configuration filedata/– folder for your documentsskills/– folder for future AI skills (like “summarize” or “translate”)
Open assister.yaml and set:
memory:
chunk_size: 512
overlap: 50
max_context: 2000
These settings control how your AI remembers context. chunk_size: 512 means it reads about 500 words at a time—good for most notes.
Step 3: Add Your Knowledge (3 minutes)
Copy your text files into the data/ folder:
cp ~/notes/*.txt ./data/
# or drag and drop in Finder/Explorer
Now index them:
assister index
Behind the scenes:
- Your files are split into 512-word chunks
- Each chunk is converted into a compact vector (embedding)
- Vectors are stored locally in
index/(uses SQLite + FAISS)
⏱️ On a modern laptop, indexing 10 small docs takes <30 seconds.
You can check progress:
assister status
Look for:
Indexed: 12 chunks
Memory used: 1.8 MB
Step 4: Talk to Your Assistant (2 minutes)
Start the interactive chat:
assister chat
You’ll see:
🤖 MyHelper: Ready. Ask me anything about your files.
👤 You:
Try asking:
What are the main points in my travel notes?
MyHelper will search your indexed documents and answer based on your files—not the internet.
🔍 How it works: When you ask a question, your words are turned into a vector. The AI searches for the most similar chunks in your index and uses them as context to generate a response.
Ask a few follow-ups:
Can you summarize the safety tips?
Who wrote about flight delays?
It remembers the context of your conversation because the chat command uses a local chat history file (conversations.json).
Step 5: Customize the Personality (optional, 1 minute)
Edit assister.yaml and set:
persona:
name: "MyHelper"
role: "A helpful assistant who answers based only on your documents."
tone: "friendly and concise"
Then restart the chat:
assister chat
Now responses will match the tone you set. Try asking:
Tell me a joke.
It might say:
“Why did the PDF go to therapy? Because it had too many unresolved issues! 😄”
🛡️ Privacy note: All processing happens on your device. No data leaves your computer unless you explicitly upload it.
Step 6: Export for Offline Use (1 minute)
To use MyHelper without the CLI later, export the assistant:
assister export --format assistant-bundle
This creates MyHelper.assist — a single file you can:
- Move to another folder
- Share with a colleague (they can load it)
- Use in a future offline app
Load it again anytime:
assister import MyHelper.assist
assister chat
Advanced: Add a Skill (bonus, 3 minutes)
Skills are like plugins for your AI. Let’s add a “summarize” skill.
- Create a new skill:
assister skill create summarize
- Edit
skills/summarize/skill.yaml:
name: "summarize"
description: "Summarizes the current conversation or a document."
prompt: |
Summarize the following text in 3 bullet points:
{{context}}
- Use it:
assister skill run summarize
It will analyze the last chat and return a concise summary.
You can create skills for:
- Translation
- Code review
- Meeting notes
- Joke generator
All skills run locally and stay private.
Troubleshooting & Tips
| Issue | Fix |
|---|---|
assister index fails | Check data/ has .txt files. Rename or convert to plain text. |
| Slow responses | Reduce max_context in assister.yaml to 1500. |
| Out of memory | Close other apps. Index smaller chunks (e.g., chunk_size: 256). |
| Wrong answers | Add clearer documents or improve chunking. Try splitting long paragraphs. |
🧪 Pro tip: Use
assister testto validate your assistant on a set of sample questions.
What’s Next? (Beyond 10 Minutes)
Now that you have a working AI assistant, consider:
- Privacy: Backup your
index/andassister.yamlregularly. - Scaling: For 100+ docs, split into categories and create multiple assistants.
- Automation: Run
assister indexvia cron or GitHub Actions to keep it updated. - Voice mode: Combine with
whisperandpyttsx4for hands-free use:
pip install whisper local-tts
assister chat --voice
- Cloud sync: Use
rcloneor Dropbox to sync your.assistfile across devices.
Why This Matters
In 2026, AI isn’t just in the cloud—it’s on your device, trained on your data, answering your questions, with your privacy intact. Tools like Assisters make that possible for everyone, not just engineers.
You just built your first AI assistant in 10 minutes. That’s not just progress—it’s a revolution in personal computing. Keep tinkering. Keep learning. And most of all, keep your data yours.
