[Introduction]
Getting Started
There are two ways to use Knovo: paste an address into the hosted scanner, or run the project locally against your own API keys.
Use the hosted app
The fastest path is the hosted scanner at /get-started. No signup is required.
- Copy a token's contract address from a block explorer, DEX, or chart.
- Paste it into the scanner and run the scan.
- Read the risk score, the liquidity and activity breakdown, and the plain-English verdict.
[ Note ]
Knovo accepts EVM addresses (
0x followed by 40 hex characters) and Solana addresses (base58, 32-44 characters). Anything else is rejected before any external request is made.Run it locally
Knovo is a Next.js 14 App Router project. Clone the repository and install dependencies:
git clone <repo-url> cd knovo-token-analyzer npm install
Configure environment variables
Create a .env.local file in the project root. Only OPENAI_API_KEY is required for the app to run end to end. Everything else degrades gracefully when unset.
| Variable | Required | Purpose |
|---|---|---|
OPENAI_API_KEY | Recommended | Generates the AI risk summary. Without it, Knovo falls back to a deterministic summary built from the score and top risk reason. |
OPENAI_MODEL | No | Overrides the default model (gpt-5.4-mini) used for summaries. |
MORALIS_API_KEY | No | Enables holder-distribution analysis (top holder %, top-10 %, holder count). Without it, scans still return market data, just no holder section. |
ETHERSCAN_API_KEY | No | Reserved for block-explorer-based contract and LP-safety checks. Not yet part of the live /api/analyze response; see Data Sources. |
# .env.local OPENAI_API_KEY=your_key_here OPENAI_MODEL=gpt-5.4-mini MORALIS_API_KEY=your_key_here
Start the dev server
npm run dev
Open http://localhost:3000 and go to /get-started to run a scan against your local server.
Other scripts
npm run build: production build.npm run start: serve the production build.npm run lint: run ESLint.