chore(config): add .env.example and overhaul README, DEPLOY, and RULES documentation

Introduce a complete `.env.example` covering Telegram, AI provider,
proactive messaging, web search, and vision settings so new users can
bootstrap configuration without reading the source.

Rework README.md with a feature list, project structure, and variable
reference tables; restructure DEPLOY.md with a table of contents,
prerequisites, and env var tables; update RULES.md to declare English
as the interface and documentation language and to document the
`iniciar.sh` entry script. Also add docstrings to schedule and web
search helpers and rename `schedule_data` to `schedule_answers` for
consistency with the other wizard state variables.
This commit is contained in:
2026-10-26 14:25:47 -03:00
parent 9848120a1a
commit fd136db535
6 changed files with 2588 additions and 187 deletions
+5 -4
View File
@@ -11,6 +11,7 @@ Official rules for AIs and developers to code the PsAgentAI system correctly, st
- **Language:** Python 3.9+
- **Framework:** python-telegram-bot (v20+)
- **Main file:** `psagentai_agent.py`
- **Entry script:** `iniciar.sh`
- **Purpose:** Personal conversational companion with memory, profiles, file workspace, image analysis, web search and automations.
### Basic rule
@@ -236,10 +237,10 @@ Always use the existing helper functions:
## 15. Language and Communication
- Bot interface: Brazilian Portuguese.
- Agent replies: Brazilian Portuguese.
- Logs and code: technical English for variable/function names; Portuguese for user-facing messages.
- Documentation: Brazilian Portuguese.
- Bot interface: English.
- Agent replies: English.
- Logs and code: technical English for variable/function names; English for user-facing messages.
- Documentation: English.
---