gitwtfhub

wtf is franklin_conviction?

crypticsaiyan/franklin_conviction — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerLicense

TL;DR

A simulated AI investment committee that debates a crypto token through seven agents and outputs a conviction score with position sizing.

Mindmap

mindmap
  root((Franklin Conviction Engine))
    What it does
      AI investment committee
      Conviction score output
    Tech stack
      TypeScript
      Express
      React
      Pyth prices
    Use cases
      Token research
      Free demo mode
    Audience
      Developers
      Crypto researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Get a structured bull versus bear analysis of a crypto token before deciding to buy.

REASON 2

Run a free, no-wallet demo to see how the multi-agent debate pipeline works.

REASON 3

Use the conviction score and stop-loss output as a starting point for a trading plan.

What's in the stack?

TypeScriptExpressReactVitePyth

How it stacks up

crypticsaiyan/franklin_conviction0xradioac7iv/tempfs7vignesh/pgpulse
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderate
Complexity3/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

Wtf does this do

Franklin Conviction Engine is a tool that assembles a simulated investment committee of AI agents to analyze a cryptocurrency token and produce a final buy/sell recommendation with suggested position sizing. Instead of a single AI answering a question, it runs seven specialized agents in a structured pipeline designed to surface disagreement and force synthesis. When you enter a token, four analyst agents run in parallel: a Bull analyst (arguing the case for buying), a Bear analyst (arguing against), a Macro analyst (looking at broader market conditions), and a Narrative analyst (examining sentiment and story). A disagreement gate then checks the gap between the Bull and Bear scores, if that gap exceeds 30 points, a premium Arbitrator agent is brought in to adjudicate. Otherwise the Arbitrator is skipped, keeping costs down. A Synthesis agent then merges all the inputs, and finally a Risk Officer issues a conviction score, entry zone, stop-loss level, position size, and time horizon. Live market prices come from BlockRun's PriceClient, which is backed by Pyth, a real-time price feed. Agents stream their outputs back to the browser as they complete, using Server-Sent Events. The tool has two modes: FREE mode, which routes all calls through zero-cost NVIDIA models and requires no API key, and SMART mode, which uses Franklin wallet routing profiles including the premium Arbitrator when needed. Each session uses a wallet key you supply yourself, nothing is stored server-side. Built with Express and TypeScript on the backend and React with Vite on the frontend. MIT licensed. The README includes a disclaimer that outputs are research scaffolding, not financial advice.

Yoink these prompts

Prompt 1
Explain how the Bull, Bear, Macro, and Narrative agents disagree and how the Arbitrator resolves it.
Prompt 2
Walk me through running Franklin Conviction Engine in FREE mode with no wallet key.
Prompt 3
What does the Risk Officer agent output at the end of the pipeline?
Prompt 4
How do I set up the frontend and backend for this project locally?

Frequently asked questions

wtf is franklin_conviction?

A simulated AI investment committee that debates a crypto token through seven agents and outputs a conviction score with position sizing.

What language is franklin_conviction written in?

Mainly TypeScript. The stack also includes TypeScript, Express, React.

Who is franklin_conviction for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.