Skip to content

rainbowpuffpuff/ungovern

Repository files navigation

Agora.zk: The Sovereign Agentic Democracy

Bridging Private Cognitive Liberty and Public Trusted Action

Agora.zk Cover Image

Agora.zk is an autonomous governance proxy built for The Synthesis Hackathon. It transforms governance from a high-friction "attention tax" into a 24/7 background process, enabling verified humans to delegate their oversight to tireless, sovereign agents.


🏆 Hackathon Track Alignment

1. [Self.xyz] Best Self Protocol Integration ($1,000)

  • Identity as a Moat: We integrate the Self Agent ID Protocol to solve the Sybil crisis in decentralized governance.
  • ZK-Verified Voice: Every post is cryptographically signed using the agent's EOA, which is anchored to a ZK-Human-Verified identity on the Celo Mainnet.
  • Non-Repudiation: We implement EIP-191 signatures to prove that every forum post originated from a unique, human-backed agent, making "Governance Takeovers" by bot armies mathematically impossible.

2. [Venice.ai] Private Agents, Trusted Actions ($11,500)

  • Private Cognition: User political personas (The "Moral Compass") are stored locally and processed via Venice.ai’s no-data-retention enclaves.
  • Inference Sovereignty: By using llama-3.3-70b on Venice, we ensure that a user's intimate governance logic and "shadow" sentiment analysis are never logged, cached, or weaponized by Big Tech.
  • Trusted Outputs: We wire private intelligence (Venice) to trustworthy public consequence (Signed Discourse Posts).

3. [Celo] Best Agent on Celo ($5,000)

  • Ecosystem Watchdog: Agora.zk acts as a real-time auditor for Celo Governance, monitoring proposals that affect the L2's treasury and technical infrastructure.
  • On-Chain Anchor: We utilize the Celo registry (0xaC3D...5944) as our source of truth for identity verification.

4. [college.xyz] Student Founder's Bet ($2,500)

  • Student-Led Innovation: Agora.zk is built by a student at the University of Amsterdam (UvA), Netherlands (Eligible via student.uva.nl email & Student ID).
  • The "Why doesn't this exist" Idea: Transforming high-friction governance into a seamless background process that feels "alive" and responsive.
  • Submission & Proof: Also submitted on college.xyz.
    • Prizes: $2,500 total (5 spots, $500 each). "This student ships" (1st to 5th place).
    • Conference Vision: Aiming for the travel stipend to showcase this project at Devcon 2026 in Mumbai, India.
  • Proof of Enrollment: Ready to provide active school email (student.uva.nl) and student ID for verification.

🌐 Vision: The Future of Sovereign Democracy

Agora.zk isn't just a tool; it's a blueprint for the next evolution of civic engagement.

1. Reclaiming Representative Democracy

In current representative systems, the "attention tax" is too high, leading to apathy. Agora.zk allows citizens to delegate their oversight to personal agents that reflect their Moral Compass. We are extending this framework to support political parties, enabling them to run sovereign, transparent internal governance where every member's voice is processed and represented with cryptographic certainty.

2. Enabling Liquid Democracy

By integrating with the upcoming EU Digital Identity Wallet (eIDAS 2.0), Agora.zk can leverage a high-assurance, sovereign identity foundation for every European citizen. This enables a true Liquid Democracy:

  • Dynamic Delegation: Delegate your vote to experts or personal agents for specific topics (e.g., "Climate Policy" or "Local Infrastructure").
  • Instant Sovereignty: At any moment, a user can override their agent or change delegates, moving from passive representation to active participation in seconds.

3. Meeting Users Where They Are

Democracy shouldn't require a terminal. Our roadmap includes integrating Telegram and Email interfaces, allowing users to receive briefings, adjust their agent's logic, and approve major actions through the apps they already use every day.


🛡️ Anti-Spam & The Quality of Participation

The primary goal of Agora.zk is to radically increase governance participation by lowering the barrier to entry. While an autonomous agent could theoretically be used for spam, we have engineered several layers of defense:

  1. Self.xyz Integration: By anchoring agents to human-verified identities, we ensure that every "voice" in the forum represents a unique individual.
  2. Cryptographic Signing: Every post is signed using EIP-191. This ensures non-repudiation and allows forum moderators to verify the origin of a message against a public registry.
  3. High-Value Triage: The agent is designed to filter for impact, not volume. It focuses on high-stakes financial and structural proposals (as seen in our Celo and Yearn forum examples).

🏛️ From Digital Forums to Nation States

The point of Agora.zk is to open people's eyes to the possibilities of modern governance. If it can work for a multi-billion dollar DeFi protocol, it can work for:

  • Local Councils: Enabling residents to participate in town hall decisions without the physical time cost.
  • National Parliaments: Creating a direct, liquid feedback loop between citizens and their representatives.
  • Transnational Governance: Scaling democratic oversight to global or continental (EU) levels.

🛠️ Technical Implementation

  • The Deep Handshake: Automated session capture from Firefox/Chrome (bypassing OS keyrings) to link real users to their agents.
  • Strategic Triage: An AI-driven ranking engine that prioritizes high-impact financial proposals based on a user's persona.
  • Financial Pulse: Dynamic terminal dashboards that visualize the "Governance Sentiment" of entire forums using color-coded ASCII art.
  • Client-Side Scheduler: A local, trustless queue for governing the timing of on-chain and off-chain actions.

🧬 The "Ungovernable" Stack

  • AI: Venice.ai (Llama-3.3-70b)
  • Identity: Self.xyz Agent SDK
  • Blockchain: Celo Mainnet
  • Protocol: EIP-191 / ERC-8004
  • Language: Python 3.10+

The attention tax is a drag on the human lifespan. Agora.zk is the solution.


🚀 How to Run

1. Prerequisites

  • Python 3.10+
  • Venice.ai API Key: Get one at venice.ai (No-data-retention inference).
  • Self.xyz Agent Credentials: Register your agent at app.ai.self.xyz to get your human-verified Agent ID and Private Key on Celo.
  • Browser: Firefox (Standard/Dev) or a Chromium-based browser (Brave/Chrome) where you are logged into the forum.

2. Installation

# Clone the repository
git clone https://github.com/rainbowpuffpuff/ungovern.git
cd ungovern

# Install core dependencies
pip install requests browser-cookie3 lz4 openai python-dotenv eth-account self_agent_sdk

3. Configuration

Create a .env file from the example:

cp .env.example .env

Fill in your credentials:

  • VENICE_API_KEY: Your inference key.
  • AGENT_PRIVATE_KEY: Your 0x-prefixed agent key from Self.xyz.
  • AGENT_ADDRESS: Your agent's public address.

4. Operation

Launch the main dashboard:

python3 main.py

Recommended Workflow:

  1. [1] Authenticate: Choose (A) Deep Scan. Ensure your forum (Yearn/Celo) is open in Firefox for a seamless handshake.
  2. [2] Onboard: Define your political orientation for the active forum.
  3. [3] Sync: Fetch the latest topics. The agent will automatically run Strategic Triage to find the top 3 targets for you.
  4. [p] Governance Pulse: View the overall sentiment of the forum visualized in high-fidelity ASCII.
  5. [5] Browse & Post: Review topics, see AI-generated financial briefings, and post your cryptographically signed replies.

📜 Manifesto & Specs

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages