Syna
The AI agent with a pod.
julynx.github.io/syna
uv tool install syna-agent
Features
- A sandboxed pod. Every command runs inside an isolated container, with a full Debian shell, root access, and your host machine out of reach.
- A complete toolset. Web search and browser automation (both local, no API key), image understanding, image generation, speech-to-text, text-to-speech, and precise line-number, diff-style file editing.
- Built for long, complex tasks. Every tool output is saved to a file, context is managed automatically (elision and compaction, with a high cache hit rate), and deliverables keep a verifiable chain of custody from source to artifact.
- Honest reporting. Syna is trained to say exactly what happened and what it can't verify; it resists prompt injection and false-flag attacks baked into web content, and it scores at the top of honesty benchmarks.
- It asks when it should. Multiple-choice or open-ended questions, mid-task, whenever a decision isn't Syna's to make.
- Voice mode. Talk to it, and it reads its answers out loud.
- A beautiful UI. Frosted glass, sound effects, and a Y2K-video-player-style background visualizer that reacts to the agent (thinking, calling tools, speaking).
- Any provider. Works with OpenRouter (recommended, most tested), OpenAI, Google Gemini, local Ollama, or any OpenAI-compatible endpoint.
Getting started
-
Install:
uv tool install syna-agent
-
Run the setup wizard and follow the steps (dependencies, provider, API key, sanity check):
syna-setup
-
Start Syna (the web UI at
http://127.0.0.1:8000, or the terminal CLI):syna # Starts the web UI (and first-run wizard if not configured) syna-cli # Starts the terminal CLI
The wizard writes a .env file in ~/.syna for you. To configure manually, create ~/.syna/.env with:
OPENROUTER_API_KEY=your-api-key
MODEL=~z-ai/glm-flash-latest # Or any model of your preference
BASE_URL=https://openrouter.ai/api/v1 # Optional: any OpenAI-compatible endpoint
THINKING_EFFORT=medium # Can be either of none|minimal|low|medium|high|xhigh|max
Voice mode is enabled by adding speech models to the same .env file:
STT_MODEL=google/chirp-3 # Transcribes microphone recordings
TTS_MODEL=google/gemini-3.8-flash-lite-tts # Reads the answers out loud
TTS_VOICE=Kore # Optional: voice of the TTS model
SPEECH_LANGUAGE=en # Optional: ISO-639-1 code, English by default
Image generation (the model's text_to_image tool) is enabled the same way:
IMAGE_MODEL=google/gemini-3.1-flash-image
Requirements: Python 3.12+ and a container engine (Podman or Docker; the setup wizard checks and installs one for you).
Privacy
Syna does not collect your personal information or send your messages anywhere except to the provider you specified. Their Terms of Service and Privacy Policy apply.
Links
1 maintainer
Metadata
1 maintainer
Release files for syna-agent 0.10.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| syna_agent-0.10.0.tar.gz | 5.3 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| syna_agent-0.10.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 10.7 MB
Release files / syna_agent-0.10.0.tar.gz
| Download URL | syna_agent-0.10.0.tar.gz |
|---|---|
| Size | 5.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
38f2e53a74cf72db29bd1bce0dfebfaffec2650092e37cb5f48cbc885aa5c959
|
|
BLAKE2b-256 checksum How to use checksums |
bf96dc832b3afd0faa640b1a6ed26369afa6d0f298508867bb461810be01f42c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / syna_agent-0.10.0-py3-none-any.whl
| Download URL | syna_agent-0.10.0-py3-none-any.whl |
|---|---|
| Size | 5.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
342303291ca0b06ea7e11dac36303b68b3d28daaa9d6fb6cf3c0f7d8bb64f1b2
|
|
BLAKE2b-256 checksum How to use checksums |
e0699a4467d62383fd8e67efe8f8e409cf1b99a8e21dfd481a318d7acbfbb895
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for syna-agent 0.10.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
