Skip to content

Snapwave333/necter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

678 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Necter

Necter — AI Desktop Agent

AI-first desktop agent that talks, thinks, and builds — in 16 languages.

GitHub release (latest) MIT License Stars Forks Last Commit CI Release Platform 16 Languages Claude PRs Welcome

🔱 Forked from Open Cowork · Built on Claude · Runs locally · Stays private


📋 Table of Contents


✨ Key Features

🗣️ Voice-first WebGL status orb · push-to-talk · Edge TTS · auto-speak in 16 languages
🧩 Skills PPTX · DOCX · PDF · XLSX generation — prompt → finished document
🖥️ Computer use Control any desktop app directly by voice or text
🤖 Any model Claude · OpenAI · GLM · MiniMax · Kimi · Ollama · any OpenAI-compatible API
🔒 VM Sandbox WSL2 (Win) / Lima (macOS) — all agent commands isolated in Linux
🔌 MCP Connectors Chrome devtools · Notion · Feishu · and custom desktop integrations
🧠 Memory Persistent session memory · workspace experience · core preferences
🌐 i18n English · 中文 · Español · Français · Deutsch · 日本語 · 한국어 · Português · Русский · العربية · हिन्दी · Italiano · Nederlands · Polski · Türkçe · Tiếng Việt
Scheduled prompts Alarm-style automation — run any task on a cron schedule
📡 Remote control Use Necter from Feishu, Slack, Telegram, and other channels

🗺️ Voice Orb

The header orb shows Necter's real-time state:

Color Meaning
💤 Idle 🟡 Cyan Waiting for input
🤔 Thinking 🔵 Blue Reasoning through a problem
🔧 Tool 🟢 Green Running a tool or command
🔍 Searching 🟡 Yellow Web search in progress
🔊 Speaking 🟣 Magenta TTS audio playing
⚠️ Error 🟠 Orange Something went wrong
💾 Memory ⚪ White Reading or writing memory
💻 Coding 🟣 Purple Writing or editing code

Push-to-talk · TTS auto-speak · independent mic + TTS mute controls.


🚀 Quick Start

1. Open the app
2. Settings → paste your API key → set Base URL + model
3. Pick a workspace folder
4. Start chatting

Recommended API setups:

Provider Base URL Model
OpenRouter https://openrouter.ai/api claude-4-5-sonnet
Anthropic (default) claude-4-5-sonnet
Zhipu AI https://open.bigmodel.cn/api/anthropic glm-4.7
MiniMax https://api.minimaxi.com/anthropic minimax-m2
Kimi https://api.kimi.com/coding/ kimi-k2

📦 Installation

macOS

brew tap Snapwave333/tap
brew install --cask --no-quarantine necter

Windows

Download the latest .exe from Releases →

Build from source

git clone https://github.com/Snapwave333/necter.git
cd necter
npm install
npm run dev

🛡️ Security

Layer Platform How
🛡️ Basic All Path guard — file access restricted to workspace folder
🔒 Enhanced Windows WSL2 VM — all agent commands run in isolated Linux
🔒 Enhanced macOS Lima VM — all agent commands run in isolated Linux

WSL2 and Lima are auto-detected. Falls back to native execution with path restrictions if unavailable.


🧰 Built-in Skills

Skill What it does
pptx Generate PowerPoint presentations from a prompt
docx Create or edit Word documents
pdf Handle PDFs, fill forms, extract text
xlsx Build Excel spreadsheets with formulas
skill-creator Create your own custom skills

👥 Who's it for?

🧑‍💻 Developers Offload boilerplate, automate terminal tasks, control dev tools by voice
🔬 Researchers Search papers, summarize to Notion, crunch datasets
Power users Automate desktop workflows without writing scripts
👥 Teams Shared skills, scheduled prompts, remote control via Feishu

🤝 Contributing

Contributions welcome! Please read CONTRIBUTING.md before submitting PRs.

contributions welcome


🙏 Thanks

Necter is built on the shoulders of giants — specifically the Open Cowork project by the OpenCowork team. If Necter is useful to you, please star ⭐ their repo too!


🔗 Links

Stars Forks Open Cowork Releases


📄 License

MIT — see LICENSE

About

No description, website, or topics provided.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors