Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/srcbookdev/srcbook
TypeScript-centric app development platform: notebook and AI app builder
https://github.com/srcbookdev/srcbook
ai javascript local notebook typescript
Last synced: 2 days ago
JSON representation
TypeScript-centric app development platform: notebook and AI app builder
- Host: GitHub
- URL: https://github.com/srcbookdev/srcbook
- Owner: srcbookdev
- License: apache-2.0
- Created: 2024-05-08T19:28:00.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-12-03T16:39:13.000Z (about 1 month ago)
- Last Synced: 2024-12-26T04:03:23.185Z (16 days ago)
- Topics: ai, javascript, local, notebook, typescript
- Language: TypeScript
- Homepage: https://srcbook.com
- Size: 2.59 MB
- Stars: 3,035
- Watchers: 26
- Forks: 218
- Open Issues: 32
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- my-awesome-list - srcbook - centric app development platform: notebook and AI app builder | srcbookdev | 3054 | (TypeScript)
- stars - srcbook - centric app development platform: notebook and AI app builder | srcbookdev | 3054 | (TypeScript)
- stars - srcbook - centric app development platform: notebook and AI app builder | srcbookdev | 3009 | (TypeScript)
- jimsghstars - srcbookdev/srcbook - TypeScript-centric app development platform: notebook and AI app builder (TypeScript)
README
Online app builder ·
Discord ·
Youtube ·
Hub## Srcbook
Srcbook is a TypeScript-centric app development platform, with 2 main products:
- an AI app builder (also available [hosted online](https://srcbook.com/))
- a TypeScript notebookSrcbook is open-source (apache2) and runs locally on your machine. You'll need to bring your own API key for AI usage (we strongly recommend Anthropic with `claude-3-5-sonnet-latest`).
## Features
### App Builder
- AI app builder for TypeScript
- Create, edit and run web apps
- Use AI to generate the boilerplate, modify the code, and fix things
- Edit the app with a hot-reloading web preview
### Notebooks
- Create, run, and share TypeScript notebooks
- Export to valid markdown format (.src.md)
- AI features for exploring and iterating on ideas
- Diagraming with [mermaid](https://mermaid.js.org) for rich annotations
- Local execution with a web interface
- Powered by Node.js
## FAQ
See [FAQ](https://github.com/srcbookdev/srcbook/blob/main/FAQ.md).
## Getting Started
Srcbook runs locally on your machine as a CLI application with a web interface.
### Requirements
- Node 18+, we recommend using [nvm](https://github.com/nvm-sh/nvm) to manage local node versions
- [corepack](https://nodejs.org/api/corepack.html) to manage package manager versions### Installing
We recommend using npx to always run the latest version from npm
```bash
# Using npm
npx srcbook@latest start# Using your pm equivalent
pnpm dlx srcbook@latest start
```> You can instead use a global install with ` i -g srcbook`
> and then directly call srcbook with `srcbook start`### Using Docker
You can also run Srcbook using Docker:
```bash
# Build the Docker image
docker build -t srcbook .# Run the container
# The -p flag maps port 2150 from the container to your host machine
# First -v flag mounts your local .srcbook directory to persist data
# Second -v flag shares your npm cache for better performance
docker run -p 2150:2150 -v ~/.srcbook:/root/.srcbook -v ~/.npm:/root/.npm srcbook
```Make sure to set up your API key after starting the container. You can do this through the web interface at `http://localhost:2150`.
### Current Commands
```bash
$ srcbook -h
Usage: srcbook [options] [command]Srcbook is a interactive programming environment for TypeScript
Options:
-V, --version output the version number
-h, --help display help for commandCommands:
start [options] Start the Srcbook server
import [options] Import a Notebook
help [command] display help for command
```### Uninstalling
You can remove srcbook by first removing the package, and then cleaning it's local directory on disk:
```bash
rm -rf ~/.srcbook# if you configured a global install
npm uninstall -g srcbook
```> if you used another pm you will need to use it's specific uninstall command
## Analytics and tracking
In order to improve Srcbook, we collect some behavioral analytics. We don't collect any Personal Identifiable Information (PII), our goals are simply to improve the application. The code is open source so you don't have to trust us, you can verify! You can find more information in our [privacy policy](https://github.com/srcbookdev/srcbook/blob/main/PRIVACY-POLICY.md).
If you want to disable tracking, you can run Srcbook with `SRCBOOK_DISABLE_ANALYTICS=true` set in the environment.
## Contributing
For development instructions, see [CONTRIBUTING.md](https://github.com/srcbookdev/srcbook/blob/main/CONTRIBUTING.md).