base on Self-hosted bookmark manager that is designed be to be minimal, fast, and easy to set up using Docker. <div align="center"> <br> <a href="https://github.com/sissbruecker/linkding"> <img src="assets/header.svg" height="50"> </a> <br> </div> ## Introduction linkding is a bookmark manager that you can host yourself. It's designed be to be minimal, fast, and easy to set up using Docker. The name comes from: - *link* which is often used as a synonym for URLs and bookmarks in common language - *Ding* which is German for thing - ...so basically something for managing your links **Feature Overview:** - Clean UI optimized for readability - Organize bookmarks with tags - Bulk editing, Markdown notes, read it later functionality - Share bookmarks with other users or guests - Automatically provides titles, descriptions and icons of bookmarked websites - Automatically archive websites, either as local HTML file or on Internet Archive - Import and export bookmarks in Netscape HTML format - Installable as a Progressive Web App (PWA) - Extensions for [Firefox](https://addons.mozilla.org/firefox/addon/linkding-extension/) and [Chrome](https://chrome.google.com/webstore/detail/linkding-extension/beakmhbijpdhipnjhnclmhgjlddhidpe), as well as a bookmarklet - SSO support via OIDC or authentication proxies - REST API for developing 3rd party apps - Admin panel for user self-service and raw data access **Demo:** https://demo.linkding.link/ **Screenshot:**  ## Getting Started The following links help you to get started with linkding: - [Install linkding on your own server](https://linkding.link/installation) or [check managed hosting options](https://linkding.link/managed-hosting) - [Install the browser extension](https://linkding.link/browser-extension) - [Check out community projects](https://linkding.link/community), which include mobile apps, browser extensions, libraries and more ## Documentation The full documentation is now available at [linkding.link](https://linkding.link/). If you want to contribute to the documentation, you can find the source files in the `docs` folder. If you want to contribute a community project, feel free to [submit a PR](https://github.com/sissbruecker/linkding/edit/master/docs/src/content/docs/community.md). ## Contributing Small improvements, bugfixes and documentation improvements are always welcome. If you want to contribute a larger feature, consider opening an issue first to discuss it. I may choose to ignore PRs for features that don't align with the project's goals or that I don't want to maintain. ## Development The application is built using the Django web framework. You can get started by checking out the excellent [Django docs](https://docs.djangoproject.com/en/4.1/). The `bookmarks` folder contains the actual bookmark application. Other than that the code should be self-explanatory / standard Django stuff 🙂. ### Prerequisites - Python 3.12 - Node.js ### Setup Create a virtual environment for the application (https://docs.python.org/3/tutorial/venv.html): ``` python3 -m venv ~/environments/linkding ``` Activate the environment for your shell: ``` source ~/environments/linkding/bin/activate[.csh|.fish] ``` Within the active environment install the application dependencies from the application folder: ``` pip3 install -r requirements.txt -r requirements.dev.txt ``` Install frontend dependencies: ``` npm install ``` Initialize database: ``` mkdir -p data python3 manage.py migrate ``` Create a user for the frontend: ``` python3 manage.py createsuperuser --username=joe [email protected] ``` Start the Node.js development server (used for compiling JavaScript components like tag auto-completion) with: ``` npm run dev ``` Start the Django development server with: ``` python3 manage.py runserver ``` The frontend is now available under http://localhost:8000 ### Tests Run all tests with pytest: ``` make test ``` ### Formatting Format Python code with black, and JavaScript code with prettier: ``` make format ``` ### DevContainers This repository also supports DevContainers: [](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/sissbruecker/linkding.git) Once checked out, only the following commands are required to get started: Create a user for the frontend: ``` python3 manage.py createsuperuser --username=joe [email protected] ``` Start the Node.js development server (used for compiling JavaScript components like tag auto-completion) with: ``` npm run dev ``` Start the Django development server with: ``` python3 manage.py runserver ``` The frontend is now available under http://localhost:8000 ", Assign "at most 3 tags" to the expected json: {"id":"11741","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"