
सुरक्षा पर ध्यान केंद्रित करने वाला एक AI व्यक्तिगत सहायक।

Stavrobot एक व्यक्तिगत AI सहायक है जो "एक AI सहायक को जितनी पहुँच चाहिए, उतनी ही और उससे अधिक नहीं" के सिद्धांत पर बनाया गया है।
इसमें एक AI सहायक की सभी अच्छी विशेषताएँ हैं, लेकिन यह सैंडबॉक्सिंग, आइसोलेशन और न्यूनतम अनुमतियों पर केंद्रित है। यह हल्का है और केवल docker compose up के साथ डिप्लॉय किया जाता है।
uv के माध्यम से pip निर्भरताओं के साथ मनमाना Python, होस्ट वातावरण से अलग।AI-सहायता प्राप्त इंस्टॉल: अपने कोडिंग AI (Claude Code, Cursor, Windsurf, आदि) को बताएं कि https://stavrobot.stavros.io/INSTALL.md प्राप्त करें और उसका पालन करें — यह आपको पूरे सेटअप के माध्यम से इंटरैक्टिव रूप से मार्गदर्शन करेगा।
मैन्युअल इंस्टॉल:
बॉट बनाने और टोकन कॉपी करने के लिए Telegram पर @BotFather को संदेश भेजें। अपनी Telegram उपयोगकर्ता ID प्राप्त करने के लिए @userinfobot को संदेश भेजें (यह चैट ID के रूप में उपयोग की जाती है)।
env.example को .env में कॉपी करें और POSTGRES_PASSWORD को किसी सुरक्षित चीज़ में बदलें और TZ को अपने टाइमज़ोन में बदलें।
config.example.toml को data/main/config.toml में कॉपी करें और आवश्यक फ़ील्ड भरें: apiKey, password, publicHostname, [owner].name, [owner].telegram (आपकी चैट ID), और [telegram].botToken। फ़ाइल में बाकी सब कुछ वैकल्पिक है।
docker compose up --build
बस इतना ही। Telegram पर अपने बॉट को संदेश भेजें और यह जवाब देगा। Signal, WhatsApp, ईमेल और अन्य विकल्पों के लिए नीचे विस्तृत सेटअप अनुभाग देखें।
config.example.toml को data/main/config.toml में कॉपी करें।authFile (या apiKey) और publicHostname सेट करें। बाकी सब कुछ वैकल्पिक है।env.example को .env में कॉपी करें और अपना टाइमज़ोन (TZ) सेट करें। Postgres क्रेडेंशियल और अन्य वातावरण सेटिंग्स भी वहाँ ओवरराइड की जा सकती हैं। POSTGRES_PASSWORD को हमेशा किसी सुरक्षित चीज़ पर सेट करें — डिफ़ॉल्ट एक कमज़ोर प्लेसहोल्डर है और इसे उत्पादन में उपयोग नहीं किया जाना चाहिए।ऐप शुरू होने के बाद, ब्राउज़र में config.toml संपादित करने के लिए /settings/config खोलें। यह
पेज HTTP Basic Auth द्वारा सुरक्षित है और कच्चा कॉन्फ़िगरेशन प्रदर्शित करता है, जिसमें इसमें मौजूद कोई भी
रहस्य शामिल हैं। एक वैध सहेजना एक <CONFIG_PATH>.bak बैकअप बनाता है, नई सामग्री सहेजता है, और ऐप को पुनः आरंभ करता है; यह किसी भी प्रगतिरत एजेंट टर्न को बाधित करता है।
plugin-runner, coder, signal-bridge, और python-runner केवल तब config.toml पढ़ते हैं
जब वे शुरू होते हैं। उन्हें प्रभावित करने वाले परिवर्तन, जैसे पासवर्ड, के लिए उन कंटेनरों को
मैन्युअल रूप से पुनः आरंभ करना आवश्यक है।
Stavrobot को config.toml में baseUrl सेट करके किसी भी OpenAI-संगत एंडपॉइंट (Ollama, LiteLLM, vLLM, आदि) या कस्टम Anthropic-संगत प्रॉक्सी की ओर इंगित किया जा सकता है। आवश्यक फ़ील्ड और उदाहरण कॉन्फ़िगरेशन के लिए config.example.toml देखें। reasoning = true केवल उन मॉडलों के लिए सेट करें जो सोच का समर्थन करते हैं, क्योंकि यही कस्टम एंडपॉइंट पर thinkingLevel को लागू करता है।
ऐप दो प्रमाणीकरण मोड का समर्थन करता है: API key या OAuth।
config.toml में apiKey सेट करें। किसी लॉगिन या लॉगआउट की आवश्यकता नहीं है।config.toml में authFile सेट करें (एक पथ जहाँ क्रेडेंशियल संग्रहीत किए जाएंगे)। लॉगिन पेज Pi द्वारा समर्थित किसी भी OAuth प्रदाता के साथ काम करता है।
<your-hostname>/login पर जाएँ। पेज पर दिए गए निर्देशों का पालन करें, और क्रेडेंशियल auth फ़ाइल में सहेजे जाते हैं। Stavrobot प्रदाता की हेडलेस लॉगिन विधि चुनता है, इसलिए आपको कभी भी किसी अगम्य localhost कॉलबैक पर रीडायरेक्ट नहीं किया जाता। Anthropic के साथ, Authorize चुनने के बाद, Anthropic एक कोड दिखाता है, जिसे आप कॉपी करके Stavrobot लॉगिन पेज में पेस्ट करते हैं। डिवाइस-कोड फ़्लो वाले प्रदाता इसके बजाय Stavrobot पेज पर कोड दिखाते हैं, और आप उसे प्रदाता की साइट पर टाइप करते हैं। यदि बॉट चलते समय auth समाप्त हो जाता है, तो यह आपके मैसेजिंग प्लेटफ़ॉर्म के माध्यम से आपको लॉगिन URL के साथ एक संदेश भेजता है।authFile पथ पर फ़ाइल को हटा दें। बॉट अगले संदेश पर अनुपस्थित क्रेडेंशियल का पता लगाएगा और आपको फिर से लॉगिन करने के लिए प्रेरित करेगा।coder कंटेनर वैकल्पिक है (केवल स्व-प्रोग्रामिंग सुविधा के लिए आवश्यक)। डिफ़ॉल्ट रूप से यह सदस्यता auth (OAuth) के साथ Claude Code का उपयोग करता है, जो मुख्य ऐप के API key से अलग है। इसके बजाय Anthropic-संगत API एंडपॉइंट का उपयोग करने के लिए, config.toml में [coder].apiKey और [coder].baseUrl दोनों सेट करें; Claude Code तब उन्हें ANTHROPIC_API_KEY और ANTHROPIC_BASE_URL के रूप में उपयोग करता है। शीर्ष-स्तरीय apiKey/baseUrl केवल मुख्य ऐप के मॉडल को कॉन्फ़िगर करते हैं और कभी भी coder को प्रभावित नहीं करते। दो [coder] कुंजियों में से केवल एक सेट करना एक स्टार्टअप त्रुटि है।
Docker Compose प्रोफ़ाइल अल्पविराम से अलग किए जाते हैं, इसलिए आप उन्हें संयोजित कर सकते हैं (जैसे COMPOSE_PROFILES=signal,coder)।
.env फ़ाइल में COMPOSE_PROFILES सेट करें ताकि उसमें coder शामिल हो (जैसे COMPOSE_PROFILES=coder, या यदि आप Signal का भी उपयोग कर रहे हैं तो COMPOSE_PROFILES=signal,coder)।docker compose --profile coder up --build[coder].apiKey/[coder].baseUrl सेट किया है तो इसे और अगले चरण को छोड़ दें): docker compose exec -u coder coder claude (यदि आपने लॉगिन नहीं किया है तो यह आपको लॉगिन करने के लिए प्रेरित करेगा)।[coder].model को Claude Code मॉडल उपनाम (sonnet, opus, या haiku) पर सेट करें।Signal के लिए एक अलग फ़ोन नंबर आवश्यक है — आपका व्यक्तिगत नंबर नहीं। एक प्रीपेड SIM या VoIP नंबर काम करता है।