Utopia Node agent - Pure Deno implementation with security sandboxing
npm install utopian**A powerful CLI for creating and managing decentralized Utopia nodes that
tackle global challenges through AI-powered collaboration.**


Run the Utopian CLI from any directory:
``bash`
deno run --allow-read=. --allow-write=. --allow-net --allow-env --allow-run=lms https://deno.land/x/utopian/mod.ts
Or clone and run locally:
`bash`
git clone https://github.com/core-nexus/utopian.git
cd utopian
deno task start
This command will:
- In a fresh directory: Create a new Utopia node from scratch
- In an existing utopia-node repo: Enhance and expand the existing node
- Overview
- Features
- Installation
- Usage
- Configuration
- Project Structure
- AI Models
- Development
- Contributing
- License
Utopian creates decentralized nodes that collaborate to address global
challenges like climate change, digital rights, and health equity. Each node:
- π― Focuses on critical global issues with AI-generated research and
solutions
- π€ Leverages AI for continuous content generation and discovery
- πΈοΈ Builds trust networks with other nodes and organizations
- π Generates comprehensive reports with data-driven insights
- π¬ Creates media content including presentations and video scripts
- π Operates continuously to discover new challenges and opportunities
- Creates structured directories for goals, foundations, trust networks, and
topics
- Initializes with critical global challenges (climate, digital rights, health
equity)
- Generates foundational documents and reports
- Research Reports: Deep analysis of global challenges with statistics and
solutions
- Trust Network Expansion: Discovery of credible organizations and
collaborators
- Topic Discovery: Identification of emerging critical challenges
- Media Creation: Presentation slides (Marp-compatible) and video scripts
- Content Synthesis: Cross-topic analysis and strategic insights
- Runs unlimited cycles of content creation and research
- Automatically discovers new topics and expands existing ones
- Builds comprehensive knowledge bases over time
- Creates actionable reports and media content
- OpenAI API: Use GPT models with your API key
- Local Models: LM Studio integration for privacy and cost control
- Auto-detection: Automatically chooses the best available option
`bash`
deno run --allow-read=. --allow-write=. --allow-net --allow-env --allow-run=lms https://deno.land/x/utopian/mod.ts
- Deno: >= 2.x
- Optional: LM Studio for local AI models
- Optional: OpenAI API key for GPT models
`bashCreate or enhance a Utopia node
deno task start
$3
| Option | Description | Default |
| ---------------- | ------------------------------- | ------------- |
|
--base | OpenAI-compatible API base URL | Auto-detected |
| --model | Model name to use | Auto-detected |
| --auto | Skip human confirmation prompts | false |$3
The CLI automatically selects the best available AI option:
1. OpenAI API (if
OPENAI_API_KEY set): Uses gpt-5 by default
2. LM Studio (local): Uses openai/gpt-oss-20b and auto-starts server
3. Custom endpoint: Specify with --base and --model flagsβοΈ Configuration
$3
`bash
OpenAI API (recommended for best results)
OPENAI_API_KEY=your_openai_api_keyLM Studio (for local/private usage)
LMSTUDIO_BASE_URL=http://localhost:1234/v1
LMSTUDIO_MODEL=your_preferred_model
`$3
1. Download and install LM Studio
2. Load a compatible model (e.g., Qwen, Llama, Mistral)
3. Start the local server (auto-started by CLI)
4. Run
npx utopian - it will automatically detect and use LM Studioπ Project Structure
After initialization, your Utopia node will have this structure:
`
utopia-node/
βββ goals/
β βββ README.md # Node objectives and vision
βββ foundations/
β βββ index.yaml # Core principles and values
βββ trust/
β βββ known_nodes.yaml # Trusted organizations and nodes
β βββ expanded-network-*.yaml # AI-discovered trust networks
βββ topics/ # Global challenges and solutions
β βββ climate-action/
β β βββ docs/overview.md # Topic analysis
β β βββ slides/presentation.md # Marp slides
β β βββ video/script.md # Video content
β β βββ reports/ # Research reports
β βββ digital-rights/
β βββ global-health-equity/
βββ reports/ # Synthesis and analysis reports
βββ media/ # Generated presentations and scripts
βββ dist/ # Compiled presentations
`π€ AI Models
$3
For Local/Free:
- GPT-OSS-20B: Good balance of performance and resource usage
For Production:
- GPT-5 (OpenAI): Good quality and reasoning
- Claude 3 (Anthropic): Excellent for research and analysis
$3
- Larger models (70B+) produce better research and insights
- Local models provide privacy and cost control
- Use
--auto flag for unattended operation with any modelπ οΈ Development
$3
`bash
git clone https://github.com/core-nexus/utopian.git
cd utopianInstall pre-commit hooks (optional)
pip install pre-commit
pre-commit install
`$3
`bash
deno task dev # Run in development mode
deno lint # Check code style
deno fmt # Format code
deno task test # Run tests
`$3
`bash
Test locally
deno task start --helpCheck formatting and linting
deno fmt --check
deno lint
`π€ Contributing
We welcome contributions! Please see our contribution guidelines
and:
1. Fork the repository
2. Create a feature branch:
git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'feat: add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request$3
- Use TypeScript for all new code
- Follow existing code formatting (
deno fmt)
- Write tests for new functionality (deno test)
- Use conventional commits (feat:, fix:, docs:, etc.)π Related Projects
- utopia-node: Reference
implementation of a Utopia node
- CoreNexus: Core Utopia ecosystem projects
π License
This project is licensed under the Apache License 2.0 - see the
LICENSE file for details.
π Support
- Issues: GitHub Issues
- Discussions:
GitHub Discussions
- Documentation: Project Wiki
---
Ready to build the future? Start your Utopia node today:
`bash
deno run --allow-read=. --allow-write=. --allow-net --allow-env --allow-run=lms https://deno.land/x/utopian/mod.ts
``_Together, we can tackle global challenges through decentralized collaboration
and AI-powered solutions._