Metadata-Version: 2.5
Name: bluesilk
Version: 0.2.0
Summary: A fast, minimal AI agent for you or a small team: DeepSeek + Telegram, zero dependencies.
Project-URL: Repository, https://github.com/wunsiang-cheng/bluesilk
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# bluesilk

A fast, minimal AI agent for you or a small team. DeepSeek + Telegram, one file, zero dependencies.

1 key + 1 bot token + your team's user IDs and you're good to go:

```sh
uv tool install bluesilk   # or: pipx install bluesilk
bluesilk                   # first run asks for the key, the token and the user IDs, then starts
bluesilk setup             # redo setup (e.g. to add a member)
```

- **Tools:** `shell` (unrestricted) and `send` (text/files to Telegram).
- **Team:** each member chats with the bot privately and gets their own conversation. Members run in parallel; memory, skills and tools are shared.
- **Long commands:** anything still running after 30s moves to the background, so the chat stays free; the result arrives when it finishes.
- **Commands:** `/new` starts a new conversation (yours only); `/reset` returns everyone to a fresh install (keys kept, old data moved to `~/.bluesilk.bak-<time>`).
- **Images:** photos you send go straight to deepseek-flash vision.
- **Feedback:** 👀 on receipt, a live status draft with a stop button, then the reply.
- **Memory:** plain files in `~/.bluesilk/` (`MEMORY.md`, `memory/`, `skills/`, `tools/`), managed by the agent itself.
- **Context:** compacted into a summary past 50% of the 1M window.
- **Reflection:** after 24h, once everyone has been idle for 30 min, it reviews history, tidies memory and writes new skills/tools, without holding up the chat.

**Trust:** every member fully controls the machine account bluesilk runs as. They can read each other's conversations and the keys in `config.json`. Only add people you'd give a login to, and give bluesilk a machine, VM or user account of its own.

Keep it running with `tmux` or `nohup bluesilk &`.
