Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/raidendotai/cofounder
ai-generated apps , full stack + generative UI
https://github.com/raidendotai/cofounder
ai api design generative javascript postgresql react tailwind typescript ui vite
Last synced: about 22 hours ago
JSON representation
ai-generated apps , full stack + generative UI
- Host: GitHub
- URL: https://github.com/raidendotai/cofounder
- Owner: raidendotai
- License: mit
- Created: 2024-09-19T00:27:55.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-11-08T20:47:03.000Z (2 months ago)
- Last Synced: 2025-01-05T01:00:10.249Z (8 days ago)
- Topics: ai, api, design, generative, javascript, postgresql, react, tailwind, typescript, ui, vite
- Language: TypeScript
- Homepage: https://cofounder.openinterface.ai/
- Size: 2.74 MB
- Stars: 5,600
- Watchers: 164
- Forks: 621
- Open Issues: 66
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Roadmap: ROADMAP.md
Awesome Lists containing this project
- jimsghstars - raidendotai/cofounder - ai-generated apps , full stack + generative UI (TypeScript)
README
# Cofounder | Early alpha release
* project - [cofounder.openinterface.ai](https://cofounder.openinterface.ai)
* 👋 [@n_raidenai](https://x.com/n_raidenai)
**cofounder**
- full stack generative web apps ; backend + db + stateful web apps
- gen ui rooted in app architecture, with ai-guided mockup designer & modular design systems
---
# Early Alpha : Unstable ⚠️
The following points are very emphasized :
- This is an **EARLY, UNSTABLE, PREVIEW RELEASE** of the project. ⚠️ Until v1 is released, it is expected to break often.
- **It consumes a lot of tokens**. If you are on a tokens budget, wait until v1 is released.
- Again, this is an early, unstable release. A first test run. An early preview of the project's ideas. Far from completion. Open-source iterative development. Work in progress. Unstable early alpha release. [etc]
### **If any of these might be issues for you, even in the slightest way, wait until v1 is released ! Do not try the current release !**
To help you guide your decision on whether or not to try the current release , here is a guide
| Situation | Recommendation |
|------------------------------------------------------------------------------------------------------|------------------------|
| I'm not sure if this tool release is mature yet, maybe it will not work as intended and I may spend millions of tokens for nothing | Do not use it yet |
| I am very excited about this tool, I hope it is perfectly production-ready, because if it's not, I will make commentary about `I spent X amount on OpenAI API calls` | Do not use it yet |
| I am not interested in code. I want to type words into a box and have my project completed; I do not want messy broken unfinished code | Do not use it yet |
| I love exploring experimental tools but I am on the fence. It's going to break halfway and leave me sad | Do not use it yet |
| Who should even try it at this point? | Nobody. Do not use it yet |
| But I really want to use it for some esoteric reason having read all the above. | Do not use it yet either |
---
https://github.com/user-attachments/assets/cfd09250-d21e-49fc-a29b-fa0c661abfc0
https://github.com/user-attachments/assets/c055f9c4-6bc0-4b11-ba8f-cc9f149387fa
---
## Important
**Early alpha release ; earlier than expected by few weeks**
Still not merged with key target features of the project, notably :
- project iteration modules for all dimensions of generated projects
- admin interface for event streams and (deeper) project iterations
- integrate the full genUI plugin :
* generative design systems
* deploy finetuned models & serve from api.cofounder
- local, browser-based dev env for the entire project scope
- add { react-native , flutter , other web frameworks }
- validations & swarm code review and autofix
- code optimization
- [...]
be patient :)
---
# Usage
## Install & Init
* Open your terminal and run
```sh
npx @openinterface/cofounder
```
Follow the instructions. The installer
- will ask you for your keys
- setup dirs & start installs
- will start the local `cofounder/api` builder and server
- will open the web dashboard where you can create new projects (at `http://localhost:4200` ) 🎉
```
note :
you will be asked for a cofounder.openinterface.ai key
it is recommended to use one as it enables the designer/layoutv1 and swarm/external-apis features
and can be used without limits during the current early alpha period
the full index will be available for local download on v1 release
```
- currently using `node v22` for the whole project.
```sh
# alternatively, you can make a new project without going through the dashboard
# by runing :
npx @openinterface/cofounder -p "YourAppProjectName" -d "describe your app here" -a "(optional) design instructions"
```
## Run Generated Apps
- Your backend & vite+react web app will incrementally generate inside `./apps/{YourApp}`
Open your terminal in `./apps/{YourApp}` and run
```sh
npm i && npm run dev
```
It will start both the backend and vite+react, concurrently, after installing their dependencies
Go to `http://localhost:5173/` to open the web app 🎉
- From within the generated apps , you can use ⌘+K / Ctrl+K to iterate on UI components
[more details later]
## Notes
### Dashboard & Local API
If you resume later and would like to iterate on your generated apps,
the local `./cofounder/api` server needs to be running to receive queries
You can (re)start the `local cofounder API` running the following command from `./cofounder/api`
```sh
npm run start
```
The dashboard will open in `http://localhost:4200`
- note: You can also generate new apps from the same env, without the the dashboard, by running, from `./cofounder/api`, one of these commands
```sh
npm run start -- -p "ProjectName" -f "some app description" -a "minimalist and spacious , light theme"
npm run start -- -p "ProjectName" -f "./example_description.txt" -a "minimalist and spacious , light theme"
```
### Concurrency
**[the architecture will be further detailed and documented later]**
Every "node" in the `cofounder` architecture has a defined configuration under `./cofounder/api/system/structure/nodes/{category}/{name}.yaml` to handle things like concurrency, retries and limits per time interval
For example, if you want multiple LLM generations to run in parallel (when possible - sequences and parallels are defined in DAGS under `./cofounder/api/system/structure/sequences/{definition}.yaml` ),
go to
```yaml
#./cofounder/api/system/structure/nodes/op/llm.yaml
nodes:
op:LLM::GEN:
desc: "..."
in: [model, messages, preparser, parser, query, stream]
out: [generated, usage]
queue:
concurrency: 1 # <------------------------------- here
op:LLM::VECTORIZE:
desc: "{texts} -> {vectors}"
in: [texts]
out: [vectors, usage]
mapreduce: true
op:LLM::VECTORIZE:CHUNK:
desc: "{texts} -> {vectors}"
in: [texts]
out: [vectors, usage]
queue:
concurrency: 50
```
and change the `op:LLM::GEN` parameter `concurrency` to a higher value
The default LLM concurrency is set to `2` so you can see what's happening in your console streams step by step - but you can increment it depending on your api keys limits
---
# Changelog
---
# Roadmap
---
# Benchmarks
---
# Community & Links
- [](https://discord.gg/2kVMzeASj9) | Community discord server by @flamecoders
---
# Docs, Design Systems, ...
**[WIP]**
---
# Architecture
[more details later]
archi/v1 is as follows :
---
# Credits
- Demo design systems built using Figma renders / UI kits from:
* blocks.pm by Hexa Plugin (see `cofounder/api/system/presets`)
* google material
* figma core
* shadcn
- Dashboard node-based ui powered by [react flow](https://reactflow.dev/)