Update handbook: restructure content and add new sections

- Add betting-on-open-source.mdx and open-superintelligence.mdx
- Update handbook index with new structure
- Remove outdated handbook sections (growth, happy, history, money, talent, teams, users, why)
- Update handbook _meta.json to reflect new structure
This commit is contained in:
eckartal 2025-09-23 18:07:50 +08:00
parent 2f85f214ea
commit 26ed125693
14 changed files with 9806 additions and 14137 deletions

View File

@ -1,3 +1,5 @@
{
"index": "Overview"
"index": "Overview",
"open-superintelligence": "Open Superintelligence",
"betting-on-open-source": "Betting on Open-Source"
}

View File

@ -0,0 +1,33 @@
---
title: "Why Open-Source"
description: "Why we're betting on open-source."
---
# Why Open-Source
AI today is concentrated in the hands of a few companies. They ask for trust, while keeping the levers of control hidden. We think that's a mistake.
When you depend on one vendor, your future is tied to their roadmap, their politics, their survival. If they get acquired, pivot, or shut down; you're stuck.
Depending on a closed vendor means giving up more than flexibility:
- Your tools only move when their priorities move
- Their pivots become your pivots
- Their acquisitions become your risks
AI has become critical infrastructure. Nations, enterprises, even small teams rely on it to think and decide. And yet, control sits with a few vendors who decide the terms of access. We believe that's not control. That's dependency dressed up as convenience. One of the most powerful invention is being steered by a handful of executives. Their values shape what billions can say, build, or ask.
*This cannot stand. It must be changed.*
## Jan's Bet
We don't believe the future of AI should be dictated by a few firms in San Francisco, Beijing, or anywhere else.
AI is revolutionary like electricity. And like electricity, it must be open. Not locked behind trust-me promises. Not steered by a handful of companies.
That's why we're building Jan, a full product suite:
- Jan Models
- Jan on Desktop, Browser, Mobile, Web
- Jan Server
- Hub, Store, evals, guardrails, the ecosystem around it
The goal is to be the open-source replacement for ChatGPT and other BigAI products, with models and tools you can run, own, and trust.

View File

@ -1,35 +0,0 @@
---
title: "How we grow"
description: "How Jan is growing"
---
# How we grow
> People care less about what you are and more about what they can get until you invite them into a purpose they share.
Jan averages 7,000 downloads per day and gets millions of impressions on social media. 150+ people join [our community](https://discord.gg/Exe46xPMbK) each week. All with $0 spent on ads.
We grow because the product is useful today and the purpose is bigger than the product. Jan takes the best of open-source AI and packages it into an easy-to-use product, with a long game: [Open Superintelligence](/handbook/why) that can run on a $1,000 laptop.
Growth happens when the right thing matches the right people with the right emotions. So it starts with the product, and the work is to make something genuinely useful, show how it works, and let others build with us. When the product helps today and can be explored tomorrow, word of mouth does most of the lifting.
## Attention is all you need
*Really, even for growth.*
Modern life is a contest for attention. We show up where attention lives; docs, code, short posts, meetups, and we show up often.
A useful lens for how we communicate comes from philosopher [Ted Cohen](https://en.wikipedia.org/wiki/Ted_Cohen_(philosopher))'s view of jokes: they land when teller and audience share background that stays unstated, and recognition clicks mid-story.
Product communication works the same way. We start from problems people already know, make a small, concrete move, and let the recognition carry the message. The best punchline is a message or visual that evokes and connects something in viewers' minds.
That's our approach to growing on the path to Open Superintelligence.
Follow/join us (at) where we're:
- [Discord](https://discord.gg/Exe46xPMb)
- [X (Twitter)](https://x.com/jandotai)
- [Threads](http://threads.net/@jandotai)
- [YouTube](https://www.youtube.com/@jandotai)
- [LinkedIn](https://www.linkedin.com/company/opensuperintelligence)
- [Bluesky](https://bsky.app/profile/jandotai.bsky.social)
- [Instagram](https://www.instagram.com/jandotai)
- [TikTok](http://tiktok.com/@jandotai1)

View File

@ -1,6 +0,0 @@
---
title: "How we make users happy"
description: "Our approach to user success and satisfaction."
---
# How we make users happy

View File

@ -1,6 +0,0 @@
---
title: "How we got here"
description: "The journey that led us to building Jan."
---
# How we got here

View File

@ -16,39 +16,21 @@ We're building superintelligence that you can self-host and use locally. Not as
Jan's Handbook is a [living document](https://en.wikipedia.org/wiki/Living_document), constantly evolving as we build the future of AI ownership.
## The Jan Handbook
## Why does Jan exist?
### [Why Jan exists](/handbook/why)
The fundamental problem we're solving and why it matters.
### [Open Superintelligence](/handbook/open-superintelligence)
Building superintelligence that belongs to everyone, not just a few tech giants. We believe the future of AI should be open, accessible, and owned by the people who use it.
### [How we got here](/handbook/history)
The journey that led us to building Jan.
### [How we grow](/handbook/growth)
Our approach to sustainable growth and community building.
### [Who we're building for](/handbook/users)
Understanding our users and their needs.
### [How we make users happy](/handbook/happy)
Our approach to user success and satisfaction.
### [How we make money](/handbook/money)
Our business model and approach to sustainable revenue.
### [How we stay wide with small teams](/handbook/teams)
Our approach to scaling impact without scaling bureaucracy.
### [How we build a world-class team](/handbook/talent)
Our approach to attracting, developing, and retaining exceptional talent.
### [Betting on Open-Source](/handbook/betting-on-open-source)
Why we're betting on open-source as the future of AI and technology. Open-source has consistently won in the long term, and AI will be no different.
---
## Quick Links
- **For new team members**: Start with [How we build a world-class team](/handbook/talent)
- **For the curious**: Start with [Open Superintelligence](/handbook/open-superintelligence)
- **For developers**: Learn about [Betting on Open-Source](/handbook/betting-on-open-source)
- **For contributors**: Check out our [GitHub](https://github.com/menloresearch/jan) and [Discord](https://discord.gg/FTk2MvZwJH)
- **For the curious**: Read about [Why Jan exists](/handbook/why)
## Our North Star

View File

@ -1,4 +0,0 @@
---
title: "How we make money"
description: "Our business model and approach to sustainable revenue."
---

View File

@ -0,0 +1,49 @@
---
title: "Why Jan exists"
description: "Short answer: Open Superintelligence."
---
# Why does Jan exist?
> Short answer: Open Superintelligence.
In 1879, Edison lit a single street in [Menlo Park](https://en.wikipedia.org/wiki/Menlo_Park,_California). What mattered wasn't the bulb. It was that power could reach homes, schools, and factories.
Electricity changed the world only when it became universal. Standard plugs, cheap generation, lines everywhere. People stopped talking about electricity and started using light, cold chains, and machines.
[Superintelligence](https://en.wikipedia.org/wiki/Superintelligence) is the same kind of story. The point is who gets the power, on what terms, and at what cost. If intelligence is open, portable, and cheap, it becomes a utility. If it isnt, it becomes a gate.
Jan exists to push intelligence toward the first path: Open Superintelligence you can run on your cheap laptop.
## What history teaches
> The world is made, and can be remade.
Every industrial wave redefined critical aspects of our daily lives:
- Factories introduced shift clocks and wage rhythms
- Steam gave way to electricity and standardized parts
- Rail, telegraph, and later networks changed how decisions travel
- Each wave pulled new bargains into being skills, schools, safety nets, labor law
So what we're interested in is who is going to write the new defaults and share in the gains.
Technology doesnt choose its path, people do. Power accrues to whoever designs, deploys, and profits from the system:
- If intelligence is closed and centralized, the gains concentrate
- If it is open, local, and participatory, the gains spread
We choose the second.
## What we're making at Jan
Jan is building Open Superinteligence. It's one product that bundles models, tools, guardrails, and connectors in a way everybody can run on a laptop, a home server, or the web.
- Open-source, so everyone can study, reproduce, improve
- Building together, so progress compounds in public
- AI for everyone, so it runs where people work, under their control
### Co-operation > competition
We believe progress is cooperative before it is competitive. People grow by working together. We've chosen [to stand on open shoulders](https://en.wikipedia.org/wiki/Standing_on_the_shoulders_of_giants). We use, contribute to, and fund open-source projects. When something exists and works, we don't reinvent the wheel to commercialize it - we upstream fixes, write docs, and make it easier to run.
Open Superintelligence is how we make that true at the scale of intelligence.
Happy to see you in this journey. Join our [community](https://discord.gg/Exe46xPMbK).

View File

@ -1,4 +0,0 @@
---
title: "How we build a world-class team"
description: "Our approach to attracting, developing, and retaining exceptional talent."
---

View File

@ -1,4 +0,0 @@
---
title: "How we stay wide with small teams"
description: "Our approach to scaling impact without scaling bureaucracy."
---

View File

@ -1,4 +0,0 @@
---
title: "Who we're building for"
description: "Understanding our users and their needs."
---

View File

@ -1,74 +0,0 @@
---
title: "Why Jan exists"
description: "Short answer: Open Superintelligence."
---
# Why does Jan exist?
> Short answer: Open Superintelligence.
[Superintelligence](https://en.wikipedia.org/wiki/Superintelligence) will change how we live. Jan exists to build Open Superintelligence that can run on a $1,000 laptop.
## The big shiny object: Superintelligence
Everyone in this field is chasing Superintelligence. It's obviously a civilizational tool in the making, and we're about to write new defaults.
Given how far-reaching this could be, we should agree it must remain open to everyone. It has to be a common effort that anyone can use and improve.
Jan is part of that effort: we build [Open Superintelligence people can run on a laptop](https://x.com/jandotai/status/1961096883410989293), a home server, or the web, and we do the work in public so others can copy, critique, and contribute.
## What history teaches
> The world is made, and can be remade.
Every industrial wave redefined critical aspects of our daily lives:
- Time & labor: factories introduced shift clocks and wage rhythms
- Scale & power: steam gave way to electricity and standardized parts
- Coordination: rail, telegraph, and later networks changed how decisions travel
- Institutions: each wave pulled new bargains into being skills, schools, safety nets, labor law
So the question is who is going to write the new defaults and share in the gains.
From guilds to standards bodies to open protocols, big leaps happen when people pool methods and maintain commons. If intelligence is built together, its defaults can reflect human needs.
## Intelligence as utility
Great tools start rare and awkward, then become ordinary:
- [Printing](https://en.wikipedia.org/wiki/Printing) nudged literacy into daily life
- [Containerization](https://en.wikipedia.org/wiki/Containerization) made trade boring (in the best way)
- [TCP/IP](https://en.wikipedia.org/wiki/Internet_protocol_suite) let every network speak
- [Electricity](https://en.wikipedia.org/wiki/Electricity) disappeared into the walls while improving everything it touched
That's when people stop noticing the tech and only notice the outcome.
### Power and Progress
We believe tech doesn't choose its path, people do. The ones who lead the progress is the ones who own engines power progress.
Progress tilts toward whoever designs, deploys, and profits from the system.
- If intelligence is closed and centralized, the gains concentrate
- If it is open, local, and participatory, the gains spread
We believe in the second one, because history repeats the same lesson:
- Factories lifted owners until schooling and labor law spread gains
- Electrification stayed in cities until co-ops and interconnection standards pushed power outward
- The internet scaled because open protocols beat gated networks
So our take is: closed, centralized systems concentrate value, while open & tinkerable systems spread it. Superintelligence has to follow the same logic.
The pattern is constant: shared rules + falling cost = broad access. Intelligence will follow the same path, and it must be open.
## What we're making at Jan
Jan is one product that bundles models, tools, guardrails, and connectors in a way everybody can run on a laptop, a home server, or the web.
So Jan is:
- Open, so everyone can study, reproduce, improve
- Together, so progress compounds in public
- For everyone, so it runs where people work, under their control
### Co-operation > competition
We believe progress is cooperative before it is competitive. People grow by working together.
We've chosen [to stand on open shoulders](https://en.wikipedia.org/wiki/Standing_on_the_shoulders_of_giants). We use, contribute to, and fund open-source projects. When something exists and works, we don't reinvent the wheel to commercialize it - we upstream fixes, write docs, and make it easier to run.
Open superintelligence is how we make that true at the scale of intelligence.
Happy to see you in this journey. Join our [community](https://discord.gg/Exe46xPMbK).

View File

@ -64,7 +64,7 @@ const config: DocsThemeConfig = {
{(() => {
const items = [
{
title: 'Jan Desktop & Mobile',
title: 'Jan Desktop',
path: '/docs/desktop',
Icon: LibraryBig,
},

File diff suppressed because it is too large Load Diff