Problem or motivation
The current Nemantix documentation provides a solid explanation of the core concepts (Agents, Toolsets, NXS scripts, and Expertise), but it lacks end-to-end practical tutorials.
Proposed solution
Introduce a structured learning path composed of:
1. 📦 Setup Guide (Prerequisite)
A dedicated setup guide that prepares the environment before any tutorial begins.
It should include:
- Python environment setup
- Installation of dependencies (
nemantix[all], requests, etc.)
- Generation of security keys (Verifier system)
- Configuration of
credentials.json
- Standard project folder structure
This ensures all users start from the same working baseline.
2. 🌤️ Tutorial 1 — Tool-Augmented Weather Agent
A beginner-friendly tutorial that introduces:
- How to create a Python Toolset
- How to connect an external API (Open-Meteo)
- How NXS scripts define agent behavior
- How the Agent executes tools through Nemantix
- How
main.py orchestrates everything
3. 📝 Tutorial 2 — Multi-Agent Todo System
An intermediate tutorial demonstrating:
- Multi-agent architecture
- Separation of responsibilities:
- Reader Agent (querying data)
- Writer Agent (modifying data)
- SQLite-based Toolset
- More advanced NXS deliberates
- Command-line orchestration with multiple agents
NXS example (if applicable)
Alternatives considered
No response
Additional context
No response
Problem or motivation
The current Nemantix documentation provides a solid explanation of the core concepts (Agents, Toolsets, NXS scripts, and Expertise), but it lacks end-to-end practical tutorials.
Proposed solution
Introduce a structured learning path composed of:
1. 📦 Setup Guide (Prerequisite)
A dedicated setup guide that prepares the environment before any tutorial begins.
It should include:
nemantix[all],requests, etc.)credentials.jsonThis ensures all users start from the same working baseline.
2. 🌤️ Tutorial 1 — Tool-Augmented Weather Agent
A beginner-friendly tutorial that introduces:
main.pyorchestrates everything3. 📝 Tutorial 2 — Multi-Agent Todo System
An intermediate tutorial demonstrating:
NXS example (if applicable)
Alternatives considered
No response
Additional context
No response